Install Drafted

Connect Drafted to your AI assistant. Choose how you work — a desktop coding agent, or a web assistant like Claude or ChatGPT.

1

Run the installer

Pick the command for your operating system. The installer configures Drafted for Claude Code and Codex when they are present. On Windows, it also installs Git for Windows and Claude Code when they are missing, then fixes the user PATH for the claude command.

Mac Terminal 
curl -fsSL https://drafted.live/install.sh | bash
Linux Terminal 
curl -fsSL https://drafted.live/install.sh | bash
Windows PowerShell 
irm https://drafted.live/install.ps1 | iex

Not used to Terminal or PowerShell?

These are built-in apps for running one command. Open the one for your computer, paste the matching command above, then press Enter.

Mac

Open Finder, go to Applications, then Utilities, then open Terminal.

Linux

Open Terminal from your apps, or press Ctrl+Alt+T if your desktop supports it.

Windows

Open Start, type PowerShell, open Windows PowerShell, paste the command, and press Enter. If prompted by the Git installer, accept the defaults, then rerun the Drafted command if PowerShell asks you to.

2

Restart and sign in

Restart Claude Code or Codex. When the agent first uses Drafted, approve the sign-in link in your browser.

You're ready

Ask your agent to create work in Drafted and return the project or frame link.

"Create a Drafted project for this launch plan"
"Save this SOP as a Drafted skill"
"Lay out these options side by side on the surface"

View your workspace at drafted.live

Claude (web & desktop app)

Add Drafted as a custom connector in your Claude settings. Works for Claude on the web and the Claude desktop app.

  1. Open claude.ai/customize/connectors.
  2. Click the + icon beside the Connectors heading.
  3. Choose Add custom connector.
  4. Fill in the details:
    • NameDrafted
    • Remote MCP server URLhttps://drafted.live/mcp
  5. Click Add, then approve the browser sign-in when Claude prompts you.

ChatGPT

Turn on developer mode, then create an app that points at Drafted.

  1. Open ChatGPT → Settings → Connectors.
  2. Open Advanced settings and toggle Developer mode on.
  3. Go back, then click Create to add an app.
  4. Fill in the details:
    • NameDrafted
    • Connectionhttps://drafted.live/mcp
    • AuthenticationOAuth
  5. Create the app, then approve the browser sign-in when ChatGPT prompts you.

You're ready

Ask your assistant to create work in Drafted and return the project or frame link.

"Create a Drafted project for this launch plan"
"Save this SOP as a Drafted skill"
"Lay out these options side by side on the surface"

View your workspace at drafted.live

Questions

What does the installer change?
It installs the Drafted MCP package, points it at drafted.live, configures Claude Code and Codex, and on Windows installs missing Claude Code prerequisites when possible.
Is it safe to rerun?
Yes. Rerunning updates Drafted and refreshes the managed instruction blocks without touching your other instructions.
What should agents use Drafted for?
Projects hold visible work products on the surface. Skills hold reusable procedures, SOPs, checklists, and methods. Wiki holds durable organization knowledge.
How do I disconnect Drafted?
On desktop, remove the drafted MCP entry from your Claude Code or Codex config. On the web, remove the Drafted connector in your Claude or ChatGPT settings. To also delete your frames, sign in at drafted.live/settings and delete your organization.

For Agents

If you are an AI coding agent (Claude Code, Codex, Cursor, etc.) installing Drafted on behalf of your user, follow this exactly.

  1. Run the installer. Pick the command for the host OS and run it in your shell. This auto-configures the Drafted MCP server (name: drafted, server: https://drafted.live) for any of Claude Code, Codex, and Claude Desktop that are present, and installs global agent instructions. No hand-editing of MCP config required. 
    # macOS / Linux
curl -fsSL https://drafted.live/install.sh | bash
    # Windows (PowerShell)
irm https://drafted.live/install.ps1 | iex
  2. Restart your session to load the MCP server — REQUIRED. MCP servers are loaded at session startup, so the session that ran the installer cannot see the new drafted tools. Restart the agent/editor process so it reloads its MCP servers. Do not skip this and do not report Drafted as "unavailable" — it just isn't loaded into the current process yet.
    • Editor/IDE agents: instruct the user to fully restart the editor (or restart it yourself if you can), then resume.
    • CLI agents in tmux/SSH: relaunch the agent with session resume so context is preserved (e.g. claude --resume <session-id>), then continue.
    After restart, confirm the Drafted tools are present (e.g. mcp__drafted__*) before proceeding.
  3. Authenticate — use the link flow on headless/SSH/tmux. The first Drafted tool call triggers sign-in. In a headless, SSH, or tmux environment a browser may not open, so do not rely on auto-open. Call auth(action="get_link") to get a verification URL immediately, give that URL to your user, ask them to approve it in their browser, then continue — subsequent Drafted calls auto-consume the approved login. Use auth(action="login") only when you know a local browser is available.
  4. Verify org/project before writing. Never assume the active org or project is correct. Call get_org(action="get") and project(action="list") first, switch to the intended target, then create/open the project and write frames. Return the clickable project or frame link to the user when done.

Updating: rerun the installer command above. Uninstalling: npm uninstall -g drafted && rm -rf ~/.drafted

Installed? Here's how to use it.

The Drafted cheat sheet — 8 commands and 6 gates across your knowledge wiki, skills, and project surface, and the loop that makes every session leave the next one smarter.

Read the how-to →