Customize

One board that scans local agent configuration for a project: instructions (AGENTS.md, CLAUDE.md …), rules, skills, MCP servers, commands, subagents, and plugins at project and user level.

Requires Paseo >= 0.9.0.

What you get

A Customize item in the sidebar's top navigation (next to New workspace, History, Search, Schedules) and in the Command Center opens the board.
Submit /customize in an agent composer to open the board. It selects the agent's Provider and workspace Project when available, updating each independently and keeping the current selection for any unavailable value.
Top-right Provider and Project pickers. The Provider menu lists enabled Paseo providers that Customize can scan, including Cursor, Cline, CodeBuddy Code, Gemini CLI, Goose, Grok Build, Kilo Code, Kiro CLI, Kimi Code, Qwen Code, and TraeCode CLI. It marks each as Built-in or ACP. Choices persist on the Paseo host; before a project is chosen, it defaults to the workspace you were last on. The Project menu lists every Paseo project.
Tabs for Instructions / Rules / Skills / MCP / Commands / Subagents / Plugins. Each tab starts with a "how it loads" note for that provider and then Project and User sections grouped by source directory.
A link icon to the left of Provider marks agents that search shared skill directories; providers without compatibility support show no icon. Cursor's icon follows its local thirdPartyExtensibilityEnabled IDE setting; OpenCode's follows its external-skill environment flags. The icon and skill explanation update on the next scan when those settings change.
A skill reachable through several symlinked roots appears once. Customize prefers the provider's native path, then .agents/skills, then another path. Same-name skills backed by different files remain separate.
For OpenCode 1.18, every discovered and permitted skill is advertised automatically, even if its frontmatter contains another agent's disable-model-invocation setting. The skill body loads only when the agent calls the skill tool; permission.skill: deny still hides a skill.
Each row shows name, description, directory, and a status:

Status	Meaning
Auto	Loaded / offered to the model without you doing anything
Conditional	Loaded when a glob, nested directory, or the agent's judgement matches
Manual only	Only when you invoke it (`/name`, `@rule`, `disable-model-invocation`, `allow_implicit_invocation: false` …)
Needs approval	Found, but the provider asks before using it (e.g. unapproved `.mcp.json` servers)
Disabled	Explicitly turned off in config (`enabled = false`, `skillOverrides: off`, `disabledMcpServers` …)
Not loaded	Present but ignored (shadowed by a higher-priority file, untrusted project, off by default)

The reason (the exact frontmatter key or config setting) is shown next to the status.

Click a row for a preview pane at the bottom (first 64 KiB / 400 lines) with Open, Reveal, and Copy path. MCP previews mask env / headers values and secret-looking arguments.

Scanning is read-only. Preview and open only accept paths returned by a scan. The list is disk evidence, not a live CLI inventory. Trust, plugin enablement, command-line flags, and newer CLI versions may change what a running agent uses. An empty category marked "No scanned location" means no verified file location is configured in Customize; it does not mean the provider lacks that capability.

Provider/Project scans are saved as private JSON snapshots in the Paseo host's plugin-data/customize/ directory ($PASEO_HOME, or ~/.paseo by default). The board shows the saved list after an app or plugin restart; hover over Rescan to see the last scan time. It scans in the background when the snapshot is at least 10 minutes old, a compatibility switch changes, no snapshot exists, or you press Rescan. A failed refresh keeps the last list visible with a retry action. Damaged or incompatible snapshots are ignored. Previews and Open recheck paths from saved snapshots against a current scan.

Plugin rows read the declared specification version from the root plugin.json $schema. A valid supported manifest shows Agent Plugins 1.0.0; a future canonical version shows its declared version with an unverified qualifier until Customize supports that schema. The badge does not validate bundled skills or MCP servers, or confirm runtime activation. For Cursor, the Plugins tab also scans local test packages under ~/.cursor/plugins/local/<plugin-name>.

Per-provider mechanisms and their sources are recorded in specs/001-customize-board/research.md and specs/003-acp-configurations/research.md.

Install

paseo plugin add koinzhang/paseo-plugins --path customize

Development

cd customize
npm install
npm run typecheck
npm test
paseo plugin install "$PWD"
paseo plugin reload customize

Provider scanners live in server/providers/; shared helpers (nested directory index, skill discovery, redaction) in server/scan-kit.ts and server/mcp.ts. The "how it loads" notes are data in shared/mechanisms.ts. UI follows the Activity design tokens (client/design-tokens.ts); npm test rejects raw font / radius / icon literals.