syllago CLAUDE.md

Syllago

A package manager for AI coding tool content. Import, export, and convert content (rules, skills, agents, prompts, hooks, commands, MCP configs) between providers. Hub-and-spoke conversion through syllago's own canonical format.

Content registries are community-driven — syllago provides the tooling but does not own or curate registry content.

Build and Test

make setup          # Configure git hooks (run once after clone)
make build          # Compile binary to cli/syllago
cp cli/syllago ~/.local/bin/syllago   # Install to PATH (REQUIRED — see below)
make test           # Run all tests

IMPORTANT: After any Go code change, you MUST do BOTH steps before declaring work complete or asking the user to test:

1. Build — make build writes the compiled binary to cli/syllago only. The Makefile has no install target.
2. Install to PATH — cp cli/syllago ~/.local/bin/syllago (or whichever path which syllago resolves to). The user's syllago command runs the binary on PATH, NOT cli/syllago. Skipping this step means the user tests against a stale binary and your fix appears not to work — wasting a full debug cycle.

If you only ran make build, the work is NOT done. Both commands are mandatory; treat them as one indivisible step.

IMPORTANT: Always run cd cli && make fmt before committing Go changes. CI enforces gofmt and will fail on unformatted code. A pre-commit hook also blocks unformatted commits locally.

For TUI visual changes, regenerate golden baselines after tests pass:

cd cli && go test ./internal/tui/ -update-golden

Key Conventions

• Hooks and MCP configs merge into provider settings files (JSON merge). All other content types use filesystem (files, dirs, symlinks).
• Hook canonical format is defined in docs/spec/hooks.md. Canonical event names are provider-neutral snake_case (before_tool_execute, not PreToolUse). Canonical tool names are descriptive lowercase (shell, file_read, file_edit). Provider-native names (CC's PreToolUse, Gemini's BeforeTool, etc.) live in the HookEvents/ToolNames maps in toolmap.go — Claude Code is a regular provider entry, not the implicit key.
• Go conventions: see cli/CLAUDE.md
• TUI component patterns: see cli/internal/tui/CLAUDE.md