You make a commit.
A feature lands. An API changes. Choobi reads the committed diff and looks for what belongs in your docs.
~/choobidocumentation companion
choobi
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.
ready when you are.interactive demo / ? help
↓a small companion for your repository.
don’t outsource your thinking.
agent coding
+ human
understanding.
AI makes it easier to build software. As systems grow, the hard part is understanding what we’ve built, how to build on top of it, and how to make building fun.
Choobi takes care of the annoying part of building: parsing through AI slop and helping you do the creative—and arguably more difficult—part of reimagining the systems.
Use cases.
onboarding.md
The internal docs people actually need.
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.
architecture.md
Help agents and humans understand the system.
Markdown files are often an agent’s first point of reference. Keeping the architecture documented helps agents understand how the system fits together—and helps your team notice redundancies, contradictions, and places to simplify.
style-guide.md
Standardize how your team understands.
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.
Commit your code.
Carry on.
Lean on tokens.
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.
Choobi follows the thread.
It finds the relevant document and makes a small, focused update in the style you choose.
The docs catch up.
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
--- README.md- Browse your projects.+ Browse and search your projects.
[main d4e5f6a] docs: add search
all caught up. back to building.
you@project:~$ █
A small agent.
With good
boundaries.
quietly doing the paperwork.
Your commits stay yours.
Choobi writes its own docs commit. It never amends, rebases, or reorders your code commits.
Nothing to document? No change.
Updates stay focused. If the docs already say what they need to say, Choobi leaves them alone.
It knows when to wait.
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.
More understanding.
More room to create.
Systems thinking belongs to everyone.
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.
Structure makes room for play.
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.
A docs companion today. A systems agent ahead.
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.
Make room
for a little
help.
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 ↗
01. install
git clone https://github.com/ilovehhhyn/choobi.git cd choobi python3 -m pip install -e .
02. choose your runtime
choobi auth claude choobi install
03. inside your repository
cd /path/to/your-project choobi init choobi