superclawd
v0.1.87
Published
Claude Code, supercharged — your team's standards, every session. The superclawd CLI loads your workspace's skills, agents, commands, workflows, and live directives into Claude Code as a plugin.
Downloads
5,722
Maintainers
Readme
SuperClawd
Give your Claude Code superpowers. SuperClawd launches Claude Code with your team's coding standards, skills, agents, commands, and workflows already loaded — so every session follows your rules automatically, no copy‑pasting context, no reminding the AI how your team works.
One command. Your standards, every session.
npm install -g superclawd
superclawd login # connect this machine in your browser (one time)
superclawd # launch Claude Code, superchargedWhat you get
- 🧠 Your skills, on tap — workspace skills and instructions load into every session and apply automatically when they're relevant.
- 🤖 Your agents — the specialized agents you've defined are available as Claude Code subagents.
- ⚡ Commands & workflows — your reusable commands and processes, ready to run.
- 🔌 Your team's MCP servers — MCP servers your workspace curates (with their secrets) are injected into every session automatically; no per-machine
.mcp.jsonto maintain. - 📏 Always‑on rules — your foundational standards stay in effect for the whole session, even after
/clearor a compaction. - 🛡️ Guardrails — your workspace's enforced rules intercept risky tool calls before they run (block, require approval, or warn) — applied to every session automatically, even under
--dangerously-skip-permissions. - 🔔 Notifications — get pinged the moment Claude needs your input or finishes a task, so you can step away and come back at the right time.
You manage all of it from your dashboard at superclawd.com — update a skill once and every teammate's next session picks it up.
Requirements
- Claude Code installed and available on your
PATH - Node.js 20+
- A SuperClawd account and workspace — sign up at superclawd.com
Install
npm install -g superclawdSet up (one time)
Connect this machine to your account in the browser — no copy‑pasting:
superclawd loginThis opens your browser. Approve the request under Settings → Devices, and the CLI receives a credential for this machine automatically. You only do this once per machine.
Manage or revoke your connected machines any time under Settings → Devices in the dashboard. Re‑running superclawd login rotates this machine's credential.
Use it
From any project directory, run:
superclawdThat launches Claude Code with your workspace's skills, agents, commands, workflows, and standards already loaded. Work as you normally would — SuperClawd applies the right context behind the scenes.
Prefer plain Claude Code for a one‑off? Just run
claudedirectly.superclawdis the supercharged way in.
Non‑interactive (print) mode
Run a single prompt and print the result — handy for scripts or testing how your workspace config behaves:
superclawd -p "review this diff and apply our code standards"This boots the same plugin (skills/agents/teams/workflows/MCP) and runs the prompt via claude -p, then exits. It never prompts for a workspace — it resolves one in order: --workspace <id> flag → SUPERCLAWD_MCP_WORKSPACE env var → your stored default. In non-interactive mode (-p, --pipelines, or no TTY) with none of those set, the CLI prints a clear error and exits — it never prompts or hangs. Add --no-capture to skip writing learned memories for the run.
Your default workspace
On more than one team or project? A connected machine works across all your workspaces. Your default workspace is the one future superclawd launches boot into, and you set it right from the startup picker.
When you run superclawd interactively, a workspace picker appears:
- ↑/↓ — highlight a workspace
- Enter — launch into the highlighted workspace for this session
d— mark the highlighted workspace as your default (shown with a ★)
For a given run, the workspace is resolved in this order: --workspace <id> flag → SUPERCLAWD_MCP_WORKSPACE env var → your stored default → (interactive only) the startup picker.
By default, every superclawd shows the picker first and boots into whatever you highlight and Enter (just for that session; your default — the ★ — stays put unless you press d). Prefer to skip the picker and boot straight into your stored default? Turn off Choose workspace at startup in superclawd config. If your stored default ever becomes inaccessible (you're removed from it, it's deleted, or its slug changes), the CLI clears it automatically and shows the picker on the next launch.
Memory
SuperClawd carries durable context across sessions through four memory tiers. The CLI participates in all of them:
| Tier | Scope | Source | How it's surfaced |
| ----------- | ----------- | ----------------------- | ------------------------------------------------------ |
| Team | workspace | Human-authored | Injected at SessionStart for everyone in the workspace |
| Repo | repo | AI-captured | Scoped to the current repo (git-remote fingerprint) |
| Agent | agent | AI-captured | Scoped to the active agent |
| Private | private | AI-captured or self-authored, per-member | Account-scoped — injected for the author only, across every workspace they belong to |
When a tier is enabled for your workspace, the CLI registers the memory MCP tools so Claude can curate it in-session:
record_memory— capture a new memorylist_memories— list existing memoriesupdate_memory— refine an existing memoryremove_memory— delete a memorysearch_memories— hybrid recall (semantic + keyword) across the visible tiers; returns index hits (titles + ids)get_memories— fetch the full bodies for index ids on demand
AI-tier memories are served at SessionStart as a small CORE (full bodies) plus a compact INDEX (titles + ids) whose bodies are pulled on demand, plus mid-session auto-retrieve via the UserPromptSubmit / PreToolUse:Read hooks (disable with SUPERCLAWD_AUTO_RETRIEVE=0).
Options — superclawd config
Run superclawd config for an interactive menu (↑/↓ to move, Space/Enter to toggle, Esc to exit):
- Notifications — your default for new sessions: get pinged when Claude needs you or finishes.
- Dangerously skip permissions — launch Claude Code without approval prompts. Off by default; turn it on only if you understand the trade‑off.
- Choose workspace at startup — show the workspace picker each time you run
superclawd. Highlight with ↑/↓ and press Enter to boot into a workspace for that session (doesn't change your default), or pressdto make the highlighted workspace your default (★). On by default; turn it off to boot straight into your stored default workspace. A stored default that becomes inaccessible self-heals — the CLI clears it and shows the picker again. - Private Memory — let the AI remember your personal preferences across all your sessions (private to you, never shared). On by default; turn it off and no private memories are captured or injected for you.
- Experimental mode — serve the live draft of any entity flagged experimental (skills and agents), instead of its stable release. Off by default; only entities explicitly marked experimental are affected (everything else still serves its stable release).
- Keep Awake — prevent your computer from sleeping while a session is running. Off by default.
Notifications
Your default lives in superclawd config. Inside a session you can flip notifications for just that session without changing your default:
/superclawd:notifications # flips on/off for this sessionHandy in‑session commands
Once Claude Code is running, these slash commands are always available:
| Command | What it does |
| --------------------------- | ------------------------------------------------------- |
| /superclawd:notifications | Toggle notifications for the current session |
| /superclawd:status | Show service status, your workspace, and credit balance |
| /superclawd:audit-work | Check the work so far against your active standards |
| /superclawd:ultrathink | Apply maximum extended thinking to the task at hand |
The plugin's slash commands are namespaced as
/superclawd:<command>— the bare form (e.g./status) is unavailable.
Keep it up to date
superclawd checks for a newer version on launch and updates itself automatically before starting, so you're never on an outdated CLI. To update manually any time:
superclawd updateCommand reference
| Command | Description |
| ---------------------------------- | ------------------------------------------------------------------------------------- |
| superclawd | Launch Claude Code with your workspace loaded |
| superclawd --resume [session-id] | Resume a prior Claude Code conversation (alias -r; omit the id to pick from a list) |
| superclawd login | Connect this machine in your browser (one time per machine) |
| superclawd config | Toggle notifications + launch options |
| superclawd update | Update to the latest version |
| superclawd version | Print the installed version |
| superclawd help | Show help |
Questions & feedback
Have a question, idea, or run into something? Join the conversation in GitHub Discussions — we read every post.
- 📚 Docs: docs.superclawd.com
- 🌐 Website: superclawd.com
- 💬 Dashboard: app.superclawd.com
License
SEE LICENSE IN LICENSE
