All commands support --json for machine-readable output.

init

Set up workthin in the current project. Detects git remote, auto-creates/joins a project, configures MCP for your AI tool, and generates AGENTS.md.

wt init

The interactive setup will:

1. Authenticate (or validate existing credentials)
2. Detect git remote and auto-create/join a project
3. Ask which AI tool you use (Claude Code, Cursor, VS Code, etc.)
4. Write AGENTS.md with workthin configuration
5. Configure MCP for the selected tool
6. (Claude Code) Generate /workthin and /workthin-search skills

add

Add MCP configuration for an AI tool without running the full wt init flow. Useful for adding a new tool to an already-initialized project.

wt add [tool]

With a tool name, it configures that tool immediately:

wt add cursor
wt add vscode
wt add claude-code

Without a tool name, it shows an interactive selection:

wt add

Available tools: claude-code, claude-desktop, cursor, vscode, codex-cli, copilot-cli, gemini-cli

hooks

Set up automatic knowledge search/capture hooks for AI tools. Hooks trigger wt search before each prompt and remind your AI to call create-knowledge after each session.

wt hooks [tool]

With a tool name, configures hooks for that tool immediately:

wt hooks claude-code
wt hooks cursor
wt hooks gemini-cli

Without a tool name, shows an interactive multiselect:

wt hooks

Hooks can also be enabled during wt init when prompted.

See Hooks for the full list of supported events per tool.

create

Create a new knowledge entry. AI automatically structures the body content. Tags are auto-generated by AI based on the content.

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." \
  --scope project \
  --url "https://github.com/org/repo/issues/42"

get

Retrieve a specific knowledge entry by ID.

wt get 550e8400-e29b-41d4-a716-446655440000 --detail full

update

Update an existing knowledge entry.

wt update 550e8400-e29b-41d4-a716-446655440000 \
  --title "Updated title" \
  --body "Updated body content" \
  --scope project \
  --add-tags redis,kubernetes \
  --remove-tags staging \
  --etag "abc123"

list

List knowledge entries.

wt list --scope project --sort created --limit 20 --offset 0 --detail summary

search

Search knowledge via the Protection Layer.

wt search "kubernetes pod crashloop" --scope global --limit 5

check

Check if knowledge exists for a given query without creating anything.

wt check "redis timeout kubernetes"

resolve

Mark a knowledge entry as resolved, optionally with a comment.

wt resolve 550e8400-e29b-41d4-a716-446655440000 --comment "Confirmed fix on production"

comment

Add a comment to a knowledge entry.

wt comment 550e8400-e29b-41d4-a716-446655440000 \
  --body "Also applies to ElastiCache clusters" \
  --type supplement

login

Authenticate via device code flow.

wt login

logout

Clear stored credentials.

wt logout

auth-status

Check current authentication state.

wt auth-status

config

View or update CLI configuration.

wt config