Docs API Dashboard

Quickstart

Zero to working Toto integration in 5 minutes. Every step is copy-paste.

Prerequisites

Step 1: Install Slash Commands

curl -fsSL https://toto.tech/install | bash

This installs all 12 Toto slash commands to ~/.claude/skills/. The installer verifies checksums and reports results:

Toto Skill Installer

  ✓ toto-setup
  ✓ toto-plan
  ✓ toto-add
  ✓ toto-start
  ✓ toto-done
  ✓ toto-status
  ✓ toto-reconcile
  ✓ toto-enrich
  ✓ toto-lint
  ✓ toto-search
  ✓ toto-help
  ✓ th

Installed 12 skills to ~/.claude/skills
✓ CLAUDE.md template installed at ~/.claude/toto/CLAUDE.template.md

Next: run /toto-setup in Claude Code to configure your API connection.

Tip: > If you have the Toto repo cloned locally, you can also run ./scripts/install-skills.sh or cp -r .claude/skills/toto-* ~/.claude/skills/.

Step 2: Get an API Key

  1. Log in to your Toto dashboard at toto.tech
  2. Go to Settings (or jump straight to the API Keys section)
  3. Under API Keys, click Create API Key
  4. Name it (e.g., "Claude Code"), select read,write scope
  5. Copy the token immediately — it starts with toto_ and is shown only once

Step 3: Configure the Connection

In Claude Code:

/toto-setup

Enter your Toto URL and API token when prompted. The command saves the config to ~/.claude/skills/toto-config.json and tests the connection.

Step 4: Verify

/toto-status

You should see your task lists. If you get "Token is empty", re-run /toto-setup.

Step 5: Your First Workflow

Plan a feature:

/toto-plan "Add user authentication"

Claude creates a list with subtasks, each enriched with metadata for automatic commit matching:

Created list: "User Auth" (#42)
  - #201 "Add auth middleware" (backend, priority: 3)
  - #202 "Create user model" (schema, priority: 3)
  - #203 "Build login flow" (backend, priority: 2)
  - #204 "Write auth tests" (test, priority: 1)

Start working on the first task:

/toto-start "Add auth middleware"

The task card glows on your dashboard. Do the work, commit, and the post-commit hook (if configured) automatically runs reconciliation to match your commit to the task.

Mark it done manually if you prefer:

/toto-done

The completion animation fires on the dashboard.

Optional: Add Hooks

Paste into ~/.claude/settings.json to automate reconciliation after every git commit and run a status sweep on session start:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command // \"\"' | grep -q '^git commit' && echo '{\"hookSpecificOutput\":{\"hookEventName\":\"PostToolUse\",\"additionalContext\":\"A git commit was just made. Run /toto-reconcile --depth 5 to match this commit against pending tasks.\"}}' || true",
            "timeout": 5
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo '{\"hookSpecificOutput\":{\"hookEventName\":\"SessionStart\",\"additionalContext\":\"Session started. Run /toto-reconcile --depth 50 to catch any unreconciled commits. Also run /toto-status to show current task progress.\"}}'",
            "timeout": 5
          }
        ]
      }
    ]
  }
}

If you already have a settings.json, merge the hooks key into your existing config.

Optional: Add to CLAUDE.md

Add this to your project's CLAUDE.md so Claude tracks work automatically:

## Toto Task Tracking

Track work via Toto slash commands:

| Command | Purpose |
|---------|---------|
| `/toto-plan [description]` | Create a list with subtasks |
| `/toto-start [id or text]` | Mark item as in_progress |
| `/toto-done [id or text]` | Mark item as done |
| `/toto-status` | Show current progress |

All Commands

/toto-setup                    Configure API connection
/toto-plan "description"       Create list with subtasks
/toto-add "task" --list N      Quick-add one task
/toto-start [id or text]       Begin working (glow animation)
/toto-done [id or text]        Finish working (completion animation)
/toto-status                   Show progress
/toto-search [query]           Search all lists (alias: /ts)
/toto-reconcile --depth N      Match commits to tasks
/toto-enrich --all             Populate bare task metadata
/toto-lint                     Audit board health
/toto-help                     List Toto commands + next-action suggestion (alias: /th)

/session is provided by gstack and pairs naturally with this workflow.

Next Steps