a little docs agent.
> more room for human thinking.
keeps your docs in step with your code.
so your team can understand it. and build on it.
don’t outsource your thinking.
AI makes it easier to build software. As systems grow, the hard part is understanding what we’ve built, helping the next person understand it, and knowing what to create next.
Choobi reduces the overhead of agent coding + human understanding. It keeps the notes in step with the code, so your team can share a clear picture of the system—and keep thinking for yourselves.
Make the system legible to the people building it—and the next person joining. Track versions, explain how the pieces fit, and preserve context across architecture, workflows, onboarding, and API updates.
Choobi keeps repository documentation current. Publishing platforms like Mintlify handle the documentation site—a complementary part of the workflow.
When documentation drops context, duplicated explanations and inefficient workflows become harder to spot. Keeping the story clear helps your team notice redundancies, contradictions, and places to simplify.
Keep a readable record of incremental changes: the method you tried, the result you recorded, and what changed next. Bring those details into your committed files or update instructions so Choobi has the evidence to document each step.
Keep building, committing, and shipping. Choobi follows Git commits and adds a separate docs update on the same branch, fitting alongside your existing pipeline.
Choose a shared tone and structure, or start with Choobi’s defaults. Keep internal docs consistent and readable at a glance, so everyone can follow what changed and how the pieces fit.
Focused edits and bounded prompts are designed to reduce token use. A structured harness validates outputs, limits retries, and checks each patch before it lands.
A feature lands. An API changes. Choobi reads the committed diff and looks for what belongs in your docs.
It finds the relevant document and makes a small, focused update in the style you choose.
A separate docs commit follows yours. See exactly what changed and why in the changelog.
you@project:~$ git commit -m "add search"
[main a1b2c3d] add search
choobi checking what changed...
[ok] found the relevant doc
[ok] updated README.md
[ok] verified the patch
[main d4e5f6a] docs: add search
all caught up. back to building.
you@project:~$ █
quietly doing the paperwork.
Choobi writes its own docs commit. It never amends, rebases, or reorders your code commits.
Updates stay focused. If the docs already say what they need to say, Choobi leaves them alone.
If an update could collide with your work, Choobi parks it for later. You can apply it when you're ready.
serious about systems. playful about building.
As more people build their own software, more people need to understand how it works. We want to work with teams that care about the whole system: its connections, tradeoffs, and the people who depend on it.
People should love their work. We want to make the messy work of understanding agent-written code easier, even fun. Clear structure and a little whimsy leave more energy for the part that is yours: thinking, experimenting, and creating.
Our longer-term vision pairs general-purpose models with continual learning from an evolving system. A quiet companion that helps maintain and mend the code, while keeping people oriented and in control. Today, Choobi starts with repository documentation.
How we want to build:
Deep conviction, high velocity, and an instinct for where the world is going, not just where it is.
One setup. Then back to your work.
You'll need Python 3.9+, Git, and the Claude or Codex CLI.
Read the full setup guide ↗
git clone https://github.com/ilovehhhyn/choobi.git cd choobi python3 -m pip install -e .
choobi auth claude choobi install
cd /path/to/your-project choobi init choobi