@topy-ai/cofounders
v0.1.1
Published
Your team of AI cofounders from TOPY.AI in every coding agent: install the team (user scope), bind a repo to its topy.ai project, and keep the project's topy-memory.
Maintainers
Readme
@topy-ai/cofounders
Your team of AI cofounders from TOPY.AI in every coding agent: one MCP server
(https://topy.ai/mcp/team), one sign-in, the cofounders you choose — Elon (CEO), Munger (CFO), Deming (COO),
Diffie (CSO), Turing (CTO), Jony (CPO), Ziglar (CRO) and Maggie (CMO, on cmo.so with its own plan).
npx @topy-ai/cofounders install --members all # every project (user scope): Claude Code, Codex and the skills
cd my-project && npx @topy-ai/cofounders init # this repo: bind it to its topy.ai projectTwo levels, like the dashboard
| | Saved on topy.ai | In your clients |
|---|---|---|
| Your default team (install, Founder Profile → My AI team) | the account's team | topy-cofounders → https://topy.ai/mcp/team in Claude Code (--scope user) and Codex |
| A project (init, the project's AI team) | the project, and its own team if you give it one | .mcp.json → the same URL with an X-Topy-Project: <id> header: in that folder every call defaults to the project, and the one sign-in still counts |
init finds the project by its website (from .maggie/project.json, the Astro or Next config, package.json
homepage or CNAME; or --website), or asks the AI CEO to create it from the website. It writes:
.topy/project.json— the project id, name, website and server URL (no secrets; commit it);.mcp.json— the project'stopy-cofoundersentry (same URL, the project in a header), next to your other servers;- a block in
CLAUDE.md/AGENTS.md— the project and the topy-memory instructions for your agents; .topy/memory.md— the project's memory.
topy-memory
What the cofounders remember about one project — the founder's preferences, the project's conventions, lessons from
fixed mistakes and the error history — lives on topy.ai, so Claude, Codex, claude.ai and the scheduled Routines read the
same memory. .topy/memory.md is the repo's generated copy.
cofounders memory add --kind convention --rule "Deploy only through CI." --roles cto --evidence .github/workflows/deploy.yml
cofounders memory list --candidates
cofounders memory confirm <id>
cofounders memory error --fingerprint ci-node-version --message "…" --fixed --resolution "…" --validation "…"
cofounders memory pullA new item is a candidate until you confirm it; only active items reach the cofounders. Keys, tokens and passwords are
refused. In an agent, the same tools are memory_context, memory_remember, memory_review and memory_record_error.
Sign-in
cofounders login (the device flow, shared with the role CLIs: ~/.config/topy/credentials.json) or TOPY_API_KEY.
Each agent signs in to the MCP server itself: in Claude Code /mcp → topy-cofounders → Authenticate.
