thinkingroot
v0.7.1
Published
ThinkingRoot CLI — `npx thinkingroot connect` wires ThinkingRoot MCP + the memory skill into every AI tool (Claude Code, Cursor, Antigravity, OpenClaw, Hermes, Codex, Windsurf) plus SDK/terminal. JSON-first for humans and agents.
Maintainers
Readme
thinkingroot — ThinkingRoot DB Cloud CLI
One command covers everything — sign in, create your ThinkingMemory, connect Cursor / Claude / Codex / SDK / terminal, and prove it live.
npx thinkingroot connectThat’s the whole product surface in one ritual. Built for humans and AI
agents: --json everywhere, non-interactive flags, env-var auth, stable exit
codes.
Setup (the hero path)
npx thinkingroot connect # picker → finishes that path (+ SDK/CLI)
npx thinkingroot connect --agent claude-code # Claude Code scenario
npx thinkingroot connect --agent everything # all tools
npx thinkingroot connect --prompt # paste into Claude/Cursor — agent integrates you
npx thinkingroot connect --yes # no prompts; full ground
npx thinkingroot connect --json --yes # agent / CI contract
npx thinkingroot connect --name "Acme ThinkingMemory"
npx thinkingroot connect --token <jwt>What setup does:
- Which agent? — Claude Code · Cursor · Codex · Windsurf · Cline · Aider · OpenCode · Goose · Amp · Desktop · App · Everything
- You — browser device-flow login (or
--token/--email) - Your ThinkingMemory — create or select a project + mint
tr_sk_ - Connect — wire that agent + SDK + CLI (or everything)
- Prove —
remember+askso you feel it working
tip: AI agents can use thinkingroot connect --prompt
Install
npm i -g thinkingroot # or use npx thinkingrootBinaries: thinkingroot and the short alias tr. Requires Node ≥ 22. Zero
runtime dependencies (native fetch + node:util).
Auth (also used by setup)
thinkingroot login # browser device-flow (default)
thinkingroot login --email [email protected] --password '…'
thinkingroot login --token <jwt-or-tr_sk_> # CI / agents| Env var | Purpose |
| --- | --- |
| THINKINGROOT_TOKEN | account session token (control-plane ops) |
| THINKINGROOT_PROJECT_KEY | tr_sk_ project key (engine ops) |
| THINKINGROOT_PROJECT | current project id |
| THINKINGROOT_GATEWAY_URL | override gateway (default https://api.thinkingroot.com) |
| THINKINGROOT_JSON=1 | force --json output |
Other commands
login | logout | whoami
setup ← start here
init scaffold a Brain-as-Code /brain folder
project list | create | use <id> | status
key list | create | revoke
push | compile | deploy
ask "<question>"
memory remember | recall | profile
agent | fn | branch | prompt | user | route
logs | status | usage
mcp print MCP client configAgent contract
--json→ one JSON document on stdout.--yes/ non-TTY → never prompts.- Exit codes:
0ok ·2usage ·3auth ·4not-found ·5rate-limit ·6unavailable.
Architecture
One operation core (src/api.mjs) behind three faces: the human CLI, the
--json agent surface, and @thinkingroot/mcp. Pure modules are unit-tested
with node --test.
