Configuration (config.json)

The Taito CLI uses a config.json file to manage user preferences, such as the target AI coding tools for installations and custom cache directories.

You can easily generate and update this configuration interactively by running:

$ taito setup

Depending on your operating system, the config.json file is located at:

• Linux: ~/.config/taito/config.json
• macOS: ~/.config/taito/config.json

{
  "storage": {
    "cacheDir": "/custom/path/to/cache"
  },
  "tools": [
    {
      "name": "claude-code",
      "path": "~/.claude"
    },
    {
      "name": "cursor"
    }
  ]
}

3.1 storage

Type: Object | Required: No Contains storage-related settings for the Taito CLI.

3.2 storage.cacheDir

Type: String | Required: No Overrides the default cache directory where pulled OCI artifacts are stored. If omitted, the platform's default cache directory is used (e.g., ~/.cache/taito on Linux, ~/Library/Caches/taito on macOS).

3.3 tools

Type: Array of Objects | Required: No A list of configured AI coding tools where skills and agents should be installed.

3.4 tools[].name

Type: String | Required: Yes (if inside a tool object) The identifier of the AI coding tool. Supported known tools include: "cursor", "windsurf", "claude-code", "opencode", and "copilot".

3.5 tools[].path

Type: String | Required: No Overrides the default configuration directory path for the specified tool. Path expansion using ~/ is supported. If omitted, Taito resolves the standard platform-specific default path for that tool.