platforms — Manage configured platforms

List or reset all configured AI coding platforms.

platforms list

List all configured platforms. By default only enabled platforms (enabled: true) are shown, sorted by display name; the NAME column shows the display name (falls back to the config key when absent):

xskill platforms list

The bare xskill platforms command is equivalent to xskill platforms list.

Default output format (columns NAME, PATH, COMPAT):

NAME         PATH      COMPAT
Claude Code  .claude   ✗
Codex        .codex    ✓

✓ in green indicates compatibility (agents_compat: true), ✗ in red indicates incompatibility.

Show detailed platform information, including disabled platforms and their ENABLED status (columns NAME, PATH, SKILLS, AGENTS, SOURCE, COMPAT, ENABLED):

xskill platforms list -a

Output format:

NAME         PATH     SKILLS  AGENTS      SOURCE     COMPAT  ENABLED
Claude Code  .claude  skills  CLAUDE.md   AGENTS.md  ✗       ✓
Codex        .codex   skills  AGENTS.md   AGENTS.md  ✓       ✓
Cline        .cline   skills  CLAUDE.md   AGENTS.md  ✓       ✗

Show detailed information for enabled platforms only (disabled platforms are hidden):

xskill platforms list -e

Options:

  • -a, --all — Show detailed information (path, skills directory, agents file, source file, agents compatibility, and enabled status) for all platforms, including disabled ones
  • -e, --enabled — Show the detailed view for enabled platforms only (enabled: true); disabled platforms are hidden. When combined with -a, the enabled filter takes precedence

Compatible platforms (agents_compat: true) are pre-selected in the interactive target-platform picker used by add, link, and related commands.

platforms reset

Reset platforms to the built-in default platform list. A skim single-select TUI is shown before applying (↑/↓ to navigate, Enter to confirm, Esc to cancel; pressing Enter selects the first item by default):

  • Full restore (first item, default) — Restore all platforms to built-in defaults, dropping custom platforms
  • Careful merge — Update built-in platforms only, keep custom platforms
  • Cancel — Make no changes

If custom platforms exist, a prompt is printed first. Other configuration fields (sources, cache, proxy, etc.) are not affected.

Example:

$ xskill platforms reset
Custom platforms: my-custom
# skim TUI: 完全恢复(默认) / 谨慎合并 / 取消
Platforms reset: 18 platforms, replaced with defaults (custom dropped)

Edge cases:

  • “No platforms configured” is printed when no platforms are configured.
  • Empty fields are displayed as -.