Set Up in One Command

npx workthin@latest init

This single command handles everything: authentication, project detection, AI tool configuration, and optional global CLI install — no pre-installation required.

Already have wt installed? Run wt init directly instead.

Create Knowledge

wt create "Redis connection timeout in staging" \
  --body "Redis connections drop after 30s idle in staging k8s pods. \
    Set tcp-keepalive 60 in redis.conf and \
    add timeout: 0 to prevent idle disconnection." \
  --scope project

AI automatically structures the body into problem, root cause, and solution fields. Tags are auto-generated by AI based on the content.

Search for Solutions

wt search "redis timeout kubernetes"

The Protection Layer returns matching knowledge ranked by relevance.

Resolve a Problem

When you encounter a known problem:

wt resolve 550e8400-e29b-41d4-a716-446655440000 --comment "Confirmed fix works on staging cluster"

workthin marks the knowledge as resolved and adds your comment.

Set Up Your AI Workflow

The fastest way to configure workthin for your AI tool:

# First time (no wt installed yet)
npx workthin@latest init

# Already have wt
wt init

This interactive command will:

1. AGENTS.md — Add the workthin knowledge loop to your project
2. MCP config — Configure the MCP server for your selected AI tool
3. Tool-specific rules — Optionally write .cursorrules, etc.

Supported Tools

Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code / GitHub Copilot, OpenAI Codex CLI, GitHub Copilot CLI, Gemini CLI. Any other MCP-compatible tool can connect manually via the MCP endpoint.

The Knowledge Loop

workthin works best when your AI tools follow the search → solve → vaccinate loop:

1. SEARCH — Before solving a problem, check if knowledge already exists
2. SOLVE — Use existing knowledge if found, or solve independently
3. VACCINATE — Capture the solution as new knowledge

# 1. Search first
wt search "redis timeout kubernetes"

# 2. Solve (you do this part)

# 3. Vaccinate
wt create "Fix redis timeout in k8s" \
  --body "Set tcp-keepalive 60 in redis.conf..." \
  --scope project

What wt init writes to AGENTS.md

wt init adds the workthin knowledge protocol to your project's AGENTS.md. The canonical content is always available at:

https://workthin.app/agents.md

For desktop AI tools (Claude Desktop, ChatGPT), copy the content from https://workthin.app/agents.md and paste it into the tool's Instructions or System Prompt field. See the Claude Desktop or ChatGPT integration guide for the full text.

For CLI tools (Claude Code, Cursor, etc.), wt init fetches the content and writes it to your local AGENTS.md automatically.

See MCP Integrations for manual configuration of individual tools.

What's Next

• Concepts — Understand knowledge, scopes, and detail levels
• CLI Commands — Full command reference
• MCP Setup — Connect to AI assistants via MCP
• MCP Integrations — Claude Desktop, Claude Code, Cursor, and more
• Skills & Commands — /workthin and /workthin-search for all AI tools