# SuperClawd **Give your Claude Code superpowers.** SuperClawd launches [Claude Code](https://claude.com/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. ```bash npm install -g superclawd superclawd login # connect this machine in your browser (one time) superclawd # launch Claude Code, supercharged ``` --- ## What 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.json` to maintain. - ๐Ÿ“ **Alwaysโ€‘on rules** โ€” your foundational standards stay in effect for the whole session, even after `/clear` or 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](https://superclawd.com)** โ€” update a skill once and every teammate's next session picks it up. --- ## Requirements - **[Claude Code](https://claude.com/code)** installed and available on your `PATH` - **Node.js 20+** - A **SuperClawd account and workspace** โ€” sign up at **[superclawd.com](https://superclawd.com)** ## Install ```bash npm install -g superclawd ``` ## Set up (one time) Connect this machine to your account in the browser โ€” no copyโ€‘pasting: ```bash superclawd login ``` This 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: ```bash superclawd ``` That 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 `claude` directly. `superclawd` is 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: ```bash 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 ` 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 ` 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 memory - `list_memories` โ€” list existing memories - `update_memory` โ€” refine an existing memory - `remove_memory` โ€” delete a memory - `search_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 press **`d`** to 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 session ``` ## Handy 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:` โ€” 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: ```bash superclawd update ``` --- ## Command 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](https://github.com/superclawd-ai/superclawd/discussions)** โ€” we read every post. - ๐Ÿ“š **Docs:** [docs.superclawd.com](https://docs.superclawd.com) - ๐ŸŒ **Website:** [superclawd.com](https://superclawd.com) - ๐Ÿ’ฌ **Dashboard:** [app.superclawd.com](https://app.superclawd.com) ## License SEE LICENSE IN [LICENSE](./LICENSE)