/os-tk-config

Configure os-tk-pi workflow settings without manually editing JSON files.

Usage

code

/os-tk-config <subcommand> [arguments]

Subcommands:
  get <key>                     Get a config value
  set <key> <value>             Set a config value
  enable <feature>              Enable a feature
  disable <feature>             Disable a feature
  mcp <subcommand>              Manage MCP servers
  list                          List all config
  edit                          Open config in editor
  reset [section]               Reset section or entire config
  add-quality <type> <command>  Add quality command
  remove-quality <type> <idx>   Remove quality command
  status                        Show configuration status
  wizard                        Interactive configuration wizard

MCP Management

`mcp list`

List enabled MCP servers.

bash

/os-tk-config mcp list

🔌 MCP Servers
────────────────────────

1. context7
   Official docs + API signatures
   ⚠️  Requires: CONTEXT7_API_KEY

2. serena
   Symbol-level LSP (requires uv)

`mcp add <server>`

Add an MCP server.

bash

# Add a specific server
/os-tk-config mcp add serena
/os-tk-config mcp add context7
/os-tk-config mcp add exa

Available servers: context7, exa, grep_app, serena, zai-web-reader, zai-web-search

`mcp remove <server|index>`

Remove an MCP server by name or index.

bash

# By name
/os-tk-config mcp remove serena

# By index (from mcp list)
/os-tk-config mcp remove 2

`mcp status`

Show MCP status and which servers need API keys.

`mcp reset`

Reset MCP configuration to defaults.

Configuration Examples

Quick Setup

bash

# Enable MCP and Serena
/os-tk-config enable mcp
/os-tk-config mcp add serena

# Add custom quality commands
/os-tk-config add-quality format "npm run format -- --write"
/os-tk-config add-quality lint "eslint ."

View Current Config

bash

/os-tk-config status
/os-tk-config get mcp.enabled
/os-tk-config mcp list

Reset and Start Over

bash

/os-tk-config reset quality
/os-tk-config mcp reset

Configuration Keys Reference

Key	Type	Default	Description
`mainBranch`	string	`"main"`	Primary branch name
`useWorktrees`	boolean	`true`	Use git worktrees
`worktreeDir`	string	`".worktrees"`	Worktree directory
`autoPush`	boolean	`true`	Auto-push after merge
`mcp.enabled`	boolean	`false`	Enable MCP servers
`mcp.servers`	array	`[...]`	List of MCP servers
`tools.serena.enabled`	boolean	`false`	Enable Serena MCP
`tools.astGrep.enabled`	boolean	`true`	Enable ast-grep
`quality.autodetect`	boolean	`true`	Auto-detect quality tools
`quality.format`	array	`["ruff format ."]`	Format commands
`quality.lint`	array	`["ruff check ."]`	Lint commands
`quality.typecheck`	array	`["ty", "pyright ."]`	Typecheck commands
`review.requiredForDone`	boolean	`true`	Require review
`review.maxIterations`	number	`3`	Max fix iterations

Available MCP Servers

Server	Description	Requires Key
`context7`	Official docs + API signatures	CONTEXT7_API_KEY
`exa`	Web search for documentation	No
`grep_app`	Cross-repo code search	No
`serena`	Symbol-level LSP (requires uv)	No
`zai-web-reader`	Deep web content extraction	ZAI_TOKEN
`zai-web-search`	Web research	ZAI_TOKEN

Examples

Enable Serena MCP

bash

# Method 1: Enable feature
/os-tk-config enable serena

# Method 2: Add to MCP servers
/os-tk-config mcp add serena
/os-tk-config set mcp.enabled true

Configure MCP Servers

bash

# List current servers
/os-tk-config mcp list

# Add context7 for docs
/os-tk-config mcp add context7

# Add serena for code analysis
/os-tk-config mcp add serena

# Remove exa
/os-tk-config mcp remove exa

# Check status
/os-tk-config mcp status

Add Quality Commands

bash

# Add format command
/os-tk-config add-quality format "custom-format ."

# Add lint command
/os-tk-config add-quality lint "custom-lint --config .lintrc"

# Add typecheck command
/os-tk-config add-quality typecheck "mypy ."

Notes

•All changes are saved to .os-tk/config.json
•The config is automatically backed up before changes (as .os-tk/config.json.bak)
•Use /os-tk-config edit for complex changes
•Use /os-tk-setup for interactive tool installation and subagent setup

Related Commands

•/os-tk-setup - Verify prerequisites, install tools, install subagent, configure MCP
•/os-tk-config mcp - Manage MCP servers