Skip to content

Guide Sync

Guide Sync lets you maintain AGENTS.md and CLAUDE.md templates centrally, then sync them to any project.

How It Works

  1. Templates are stored at ~/.config/spectra/guides/
  2. Open Guide Sync via Shell > Guide Sync or the Command Palette
  3. Edit templates in Raw mode, preview in Preview mode
  4. Sync to the current project or all enabled projects

Template Location

~/.config/spectra/guides/
├── AGENTS.md ← your AGENTS.md template
└── CLAUDE.md ← your CLAUDE.md template

On first run, Spectra seeds default templates if none exist.

Sync Actions

ActionEffect
Sync Current ProjectCopies templates to the sidebar’s root directory
Sync All EnabledCopies templates to all configured project paths

Editing

  • Raw mode: full text editor with save support
  • Preview mode: rendered Markdown (read-only)

Changes are saved back to ~/.config/spectra/guides/ — the single source of truth.