Overview

When you run wt init or wt add, workthin automatically generates slash commands for your selected AI tool:

• /workthin — Capture the current session's solution as knowledge
• /workthin-search — Search for existing knowledge before solving a problem

These files are committed to git, so all team members get them automatically.

Supported Tools

/workthin — Capture Knowledge

Use after solving a problem to record the solution.

/workthin

What it does:

1. Reviews the current conversation
2. Identifies the key problem(s) solved
3. Checks for duplicate knowledge (check-knowledge)
4. Creates a new knowledge entry with AI-structured problem/solution
5. Returns suggested_scope — if it recommends a different scope, asks you to confirm

For multiple problems in one session, it creates separate entries and chains them with prev_knowledge_id.

/workthin-search — Find Existing Knowledge

Use when encountering a technical issue to check if a solution already exists.

/workthin-search redis connection timeout

What it does:

1. Searches workthin with the problem description
2. Shows top matches with titles and solution summaries
3. Retrieves full details if needed
4. If no results found, reminds you to use /workthin after solving

Auto-invocation

Both commands can be invoked automatically by your AI tool when it detects a relevant situation:

• /workthin — triggered when a problem has been solved
• /workthin-search — triggered when encountering a technical issue

This enables the search → solve → capture loop without manual intervention.

Claude Code Extras

When Claude Code is selected, wt init / wt add also adds a SessionStart hook to .claude/settings.json:

workthin connected. SEARCH before solving, capture after. Use /workthin to save solutions.

This reminder is displayed at the start of every session.

File Locations by Tool

Claude Code

.claude/
├── skills/
│   ├── workthin/
│   │   └── SKILL.md
│   └── workthin-search/
│       └── SKILL.md
└── settings.json          # SessionStart hook

Cursor

.cursor/
└── commands/
    ├── workthin.md
    └── workthin-search.md

GitHub Copilot CLI

.github/
└── prompts/
    ├── workthin.prompt.md
    └── workthin-search.prompt.md

Gemini CLI

.gemini/
└── commands/
    ├── workthin.toml
    └── workthin-search.toml

OpenAI Codex CLI

.agents/
└── skills/
    ├── workthin/
    │   └── SKILL.md
    └── workthin-search/
        └── SKILL.md