Skip to content

Tuskway for Claude Code

Claude Code, with a plan your whole team agreed on.

Claude Code is great at building a ticket. It is less great at remembering what your team decided last Tuesday. The Tuskway plugin gives every Claude Code session the feature's context, its tech design and a ticket brief to build from, and the same spec reaches your teammates' agents in other tools.

Start 14-day trialInstall for Claude Code

What changes

What Claude Code gets from Tuskway.

  • Four slash commands

    The plugin adds /start-epic, /write-design, /draft-tickets and /tackle-ticket, so Claude Code walks a feature from idea to pull request the same way every time.

  • Only the context it needs

    /tackle-ticket reads the brief and the one design section tied to it, not the whole design. Sessions start with focused context, not a wall of notes.

  • Review threads it can close

    Comment on a line of the design. Ask Claude Code to process the comments: it edits the doc, says what changed and resolves each thread.

Setup

Connect Claude Code in a minute.

Then run the workflow from Claude Code, one command per step:

  1. /start-epicCapture the goal, constraints and open questions.
  2. /write-designDraft the tech design in sections your team reviews.
  3. /draft-ticketsSplit it into briefs with acceptance checks.
  4. /tackle-ticketBuild one ticket from its brief and design section.

Tuskway plugin

The plugin includes the MCP server and the Tuskway workflow skills: start an epic, write the design, draft tickets and tackle them. You connect once.

  1. 1

    Install the plugin.

    Install
    /plugin marketplace add tuskway/plugin
/plugin install tuskway@tuskway
  2. 2

    Sign in: run /mcp and select plugin:tuskway:tuskway.

  3. 3

    Say “set up Tuskway”. The setup skill checks the connection, finds your workspace and suggests what to do next.

Without the plugin: MCP server only· show

Connects the tools without the workflow skills. The plugin already includes this server, so use one or the other. If you switch to the plugin, remove this connection.

Run it once, then type /mcp in Claude Code to sign in.

Terminal
claude mcp add --transport http tuskway https://tuskway.com/mcp

Step-by-step guide: set up Tuskway in Claude Code

FAQ

Claude Code questions.

Does the plugin replace CLAUDE.md?

No. Keep CLAUDE.md for your repository's conventions. Tuskway holds the work in progress for each feature: decisions, design and tickets, shared with teammates who may not use Claude Code.

Can Claude Code run in the cloud or in CI with Tuskway?

Yes. Background runs connect with a workspace bot token stored as a secret. You can make it expire and revoke it at any time.

Your teammates use something else? Same spec.

Give Claude Code a plan your team agreed on.

Every agent on the team reads the same spec, whatever tool it runs in.

Start 14-day trialSee how it works