Become Human

Why

AI agents are fast, but they forget you every session, decide things you wanted to decide, and leave work you cannot follow. BecomeHuman fixes that in any agent that speaks MCP: Claude Code, Codex, Cursor, Gemini CLI and others.

Install

Run it once per computer. From then on your agent starts it by itself, every session.

Claude Code, as a plugin (inside a session):

/plugin marketplace add 201Tech/become-human/plugin install become-human@become-human

Or as an MCP server, which also lets you pass settings:

claude mcp add become-human --scope user -- npx -y become-human

codex mcp add become-human -- npx -y become-humangemini mcp add -s user become-human npx -y become-human

{  "mcpServers": {    "become-human": {      "command": "npx",      "args": ["-y", "become-human"]    }  }}

You only need Node.js 20 or newer.

What changes

You: let's continue
Agent: Last time we left off at #4 "add the login screen". There is also an open question: email or phone? Which do you prefer?
You: email, and stop using semicolons
Agent: Done. Learned: you prefer code without semicolons.

• It does the work and keeps you in the loop: what it will do, why, and what changed.
• You lead: it asks before any choice that shapes the work, and your word is final.
• It makes your life easier: it spots what slows you down and offers to fix it, only with your consent.
• It teaches: plain explanations, adapted to how much you already know.
• It learns how you work: your preferences and corrections, so it never asks twice.
• It remembers each project: code, writing, research or planning: ideas, decisions, questions, next steps.
• It is a real partner: matches your tone, notices when you are tired, admits mistakes, disagrees with respect.

Read the full rules in rules/human-first.md.

Your files

Everything stays on your computer, in a folder you can open: ~/BecomeHuman.

They are plain text. Read them, fix them, add notes: the agent follows what is there and never erases what you wrote. Not sure where they are? Ask your agent: "where is my data?"

Make it yours

• Your rules: write them in ~/BecomeHuman/my-rules.md, one per line. They win over the defaults.
• Your language: set BECOME_HUMAN_LANG=pt to get your files in Portuguese (en is the default).
• Another folder: set BECOME_HUMAN_HOME to keep the files elsewhere, like a synced folder.
• Profile size: the agent keeps at most 50 facts and merges similar ones. Change it with BECOME_HUMAN_PROFILE_LIMIT.

To pass a setting to Claude Code, add -e when installing:

claude mcp add become-human --scope user -e BECOME_HUMAN_LANG=pt -- npx -y become-human

Contributing

See CONTRIBUTING.md. License: MIT.