Become Human

io.github.DanielDDHMPublished by GitHub account DanielDDHMv0.6.3Updated Nov 12, 2026

Your AI agent, working with you: learns how you work, remembers each project, lets you lead.

The publisher's own server: TAP

Overview

AI-generated overview

Local MCP server that gives an agent a persistent profile of how you work and a per-project idea map, stored as editable Markdown files.

What you can do
  • Save, review and remove learned preferences, habits and corrections about the user
  • Read the full profile of what has been learned, plus the server's working rules
  • Record ideas, decisions, questions and next steps in a per-project map, linked by parent node
  • Mark questions answered and next steps done, and read a project's full map with open items
  • Report where the local BecomeHuman files live and what each one holds
When to use it
Useful when you want an agent to stop re-asking the same preferences across sessions and to pick up a project where it left off. Suits people who work with one agent over many sessions on code, writing, research or planning and want the state kept in plain files they can read and edit.
Requirements
Node.js 20 or newer; installed once per computer and started by the agent via npx. Optional environment variables: BECOME_HUMAN_HOME to choose the data folder (default ~/BecomeHuman), BECOME_HUMAN_LANG for file language (en or pt), BECOME_HUMAN_PROFILE_LIMIT for the maximum number of stored facts. No account or API key.
Before you install
The server writes and deletes entries in local Markdown files under the data folder, including removing learned facts via forget. It also injects behavioral rules into every session, and user-written rules in my-rules.md take precedence. The instructions tell the agent not to store secrets or sensitive personal data, but the profile is plain text on disk, so review what gets remembered.

Installation

In SourceWeft

  1. Open Become Human in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

BecomeHuman

__________ __________ =====-' [o] [o] ]=[]=[]=[]=[]=[> * <__________( '-===== [====] (______ [====] (______ =====-._______[====] (_______.______.-===== machine human

Your AI agent, working with you. Not just for you.

Install · What changes · Your files · Make it yours

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:

bash
claude mcp add become-human --scope user -- npx -y become-human
Codex, Gemini CLI, Cursor and others
bash
codex mcp add become-human -- npx -y become-humangemini mcp add -s user become-human npx -y become-human

For Cursor, Windsurf, Claude Desktop and any other agent, add this to its MCP config:

json
{  "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.

FileWhat is inside
profile.mdWhat the agent learned about you, grouped by topic
my-rules.mdYour own rules for every agent
maps/<project>.mdOne checklist per project: ideas, decisions, questions, next steps

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:

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

Contributing

See CONTRIBUTING.md. License: MIT.

Source: README.md at commit 27bee3f

Tools

8

get_rules

Reread the rules for working with your human.

Takes no parameters.

remember

Save one preference, habit or correction about your human. Tell them in one line.

Parametersfactrequiredcategoryrequired

forget

Remove a learned fact. Pass words from it; it must match exactly one fact.

Parametersfactrequired

get_profile

Everything learned about how your human works.

Takes no parameters.

get_map

Full idea map of a project, plus what is still open.

Parametersprojectrequired

map_add

Record an idea, decision, question or next step. parentId links it to a node.

ParameterskindrequiredtextrequiredprojectrequiredparentId

map_resolve

Mark a question answered or a next step done.

Parametersidrequiredprojectrequired

where_is_my_data

Where the human's BecomeHuman files are and what each holds.

Takes no parameters.

Version history

2
  1. v0.6.3LatestNov 12, 2026
  2. v0.6.0Nov 11, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Human integrations