Skip to content

multi-platform.md

Latest commit

 

History

History
102 lines (68 loc) · 2.51 KB

multi-platform.md

File metadata and controls

102 lines (68 loc) · 2.51 KB

Multi-Platform Support

Knowns can sync instruction files and built-in skills for several AI platforms.

Multi-Platform Sync

Supported Platforms

Platform Instruction File Skills Notes
Claude Code CLAUDE.md .claude/skills/ Supports .mcp.json setup via knowns mcp setup
OpenCode OPENCODE.md - Instruction file generated by knowns sync
Gemini CLI GEMINI.md - Instruction file generated by knowns sync
GitHub Copilot .github/copilot-instructions.md - Instruction file generated by knowns sync
Generic agents AGENTS.md - Broad compatibility target

Built-in skill syncing is currently implemented for Claude-style skill folders. Top-level instruction file syncing is handled by knowns sync.

Sync Commands

Use the actual CLI commands:

# Sync skills and instruction files
knowns sync

# Sync skills only
knowns sync --skills

# Sync instruction files only
knowns sync --instructions

# Sync a single instruction target
knowns sync --instructions --platform claude

# Overwrite existing generated files
knowns sync --force

For backwards compatibility, knowns agents --sync still exists for instruction files only.

Init Behavior

knowns init can create instruction files during project setup. The exact files depend on your selected platforms and current project config.

Common generated files include:

  • KNOWNS.md
  • CLAUDE.md
  • OPENCODE.md
  • GEMINI.md
  • AGENTS.md
  • .github/copilot-instructions.md

If MCP is selected during setup, Knowns can also create .mcp.json for Claude Code discovery.

Platform Selection in Config

Project config can restrict which platforms are active:

{
  "settings": {
    "platforms": ["claude-code", "opencode", "gemini", "copilot", "agents"]
  }
}

If settings.platforms is empty or omitted, Knowns treats all supported platforms as enabled.

Instruction File Markers

Generated instruction content is wrapped in markers:

<!-- KNOWNS GUIDELINES START -->
# Knowns Guidelines
...
<!-- KNOWNS GUIDELINES END -->

When markers already exist, Knowns replaces only the generated section and preserves the rest of the file.

Related