📝

“hamroh” harness framework

I'm open-sourcing hamroh project, AI agent harness.

Check it, run it: hamrohhamroh

Run self-evolving AI assistant. It lives in your Telegram. Remembers every conversation. Schedules its own work. Messages you first when something matters: a Jira ticket due, a build that broke, etc.… Example, give a task: "research global tech trends, find problems worth solving in Uzbekistan, build me a prototype." All will be done, your creativity is the limitation.

To test: Join @rustamz_workshop telegram group, Luna, my assistant is already there.

What you can do with it today:

  • Drop it in your team chat → it tracks who's blocked, what shipped, writes the standup
  • DM it → personal chief of staff with reminders, notes, daily check-ins
  • Give it shell + code access → it ships PRs while you sleep
  • Point it at a topic → it watches your messages, scrapes pages, pings you when something turns
  • More examples in readme, check code

It is easy to extend, you can connect any existing MCP, skill. Refer to readme.md to understand how it works. Also check docs. Runs on your laptop or any small VPS. Works with your existing Claude Code subscription.

Technical depth, for the human devs hamroh under the hood:

  • Python harness, runs claude code as a subprocess via local MCP, so it pipes your request to CC (next step: rewrite project for open source models, don't rely on CC)
  • Agents have self-reasoning loop before responding to message
  • Local MCP has many tools like sending messages, scheduling tasks, taking notes, etc
  • Persistent memory: sqlite + plain markdown files
  • One process per bot, run a fleet with separate hamroh processes
  • plugins.json — you can connect external MCP servers, or turn off local MCP tools and skills
  • skills/ — add agent skills
  • You can turn on shell access, and your assistant will be able to write code, run it, test it — basically do everything autonomously, depending on your workflow setup
  • access.json — for controlling assistant access to groups and DMs
  • Runs anywhere, docker image is there already

So, the project is easily extendable, that was the goal, you can take what is done for nanoclaw, openclaw, and setup for hamroh. The coolest feature: add your assistant to group for collaboration with team. The assistant remembers things, learns from you, and you manage everything from Telegram.

SuperMade with Super