Skip to content
ctok

Installation

No app store, no account, no signup. Clone the repo and the whole toolkit works locally in one command.

Terminal window
git clone https://github.com/ctok-cli/ctok.git
cd ctok


# macOS / Linux
./scripts/setup.sh


# Windows (PowerShell)
./scripts/setup.ps1


# any OS, after `corepack enable`
pnpm setup

setup installs dependencies, builds every package, and links the ctok binary onto your PATH. Add --no-link (or -NoLink on PowerShell) to skip the global symlink and run via pnpm start -- <args> from the repo root.

Requirements: Node.js ≥ 20 and pnpm (the script enables it via corepack if missing).

CLI from npm

The CLI is published, so npm works too:

Terminal window
npm install -g @ctok/cli
# or
pnpm add -g @ctok/cli

Verify

Terminal window
ctok --version    # 0.1.0
ctok doctor       # checks environment, config, plan detection

Web playground

No install needed - open ctok-cli.github.io/ctok/playground/ in any browser.

MCP server

Add to your Claude Code config (~/.claude.json):

{
  "mcpServers": {
    "ctok": {
      "command": "npx",
      "args": ["-y", "@ctok/mcp"]
    }
  }
}

Restart Claude Code. Four tools appear: estimate, refine, recommend_model, scan_project.

Desktop app

Build it locally from your clone - no App Store account needed:

Terminal window
pnpm install
pnpm -F @ctok/desktop tauri build     # or: tauri dev

The binary lands in packages/desktop/src-tauri/target/release/. Because it is unsigned, macOS Gatekeeper / Windows SmartScreen may warn on first launch - right-click → Open (macOS) or More info → Run anyway (Windows). Requires the Tauri prerequisites for your OS.

Browser extension

Build it and load it unpacked - no Chrome Web Store account needed:

Terminal window
pnpm install
pnpm -F @ctok/browser-ext build

Then open chrome://extensions (or edge://extensions), enable Developer mode, click Load unpacked, and select packages/browser-ext/dist. See USAGE.md for the Firefox path.