Persona launcher for Claude Code — manages Claude Code personas with MCP server integration, environment variables, and keychain secrets
This is a shell-script-based MCP server with 14 tools. Most tools lack proper input schemas, parameters are inferred from zsh argument parsing rather than explicitly defined JSON Schema. Descriptions exist but are often generic or incomplete. No output schemas are documented. The server manages MCP configurations and macOS keychain secrets, but the tool definitions are not formally registered with the MCP protocol; they are shell functions. This violates the core requirement that tools be registered with explicit schemas and descriptions.
Launch Claude Code with a selected persona, optionally resuming a past session
Output persona state as JSON including roots, scratch directory, and per-persona metadata
Display the persona tree with origins (repo vs global), base layer indicators, and onboarding help
Print the clau persona authoring skill documentation
Install the clau persona authoring skill to the project or global .claude directory
Add an MCP server to one or more personas with stdio or http transport, environment variables, and headers
List MCP servers configured for one or all personas
Tools are not formally registered with MCP protocol. They are shell functions with inferred schemas, not explicit JSON Schema definitions. The MCP spec requires tools to be registered with name, description, and inputSchema.
No output schemas documented. Tools return unstructured text or JSON without declaring the response structure. LLMs cannot plan downstream calls or extract fields reliably.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
Remove an MCP server from one or more personas
Audit all stored clau:* secrets for length and readability, flagging truncated values
Check if a secret exists in the macOS login keychain
Retrieve a secret value from the macOS login keychain
List all stored clau:* secrets in the macOS login keychain
Delete a secret from the macOS login keychain
Store a secret value in the macOS login keychain with optional approval prompt on read
Parameter descriptions are minimal or missing. 'persona' is described as 'Optional persona name; if omitted, picker is invoked' but lacks guidance on format (path vs name). 'env' and 'header' arrays lack examples of expected format.
Tool names use hyphens and flags (clau -h, clau --json) instead of verb_noun convention. 'clau -h' and 'clau --json' are not action verbs; they should be 'describe_personas' and 'export_personas_json'.
No error handling guidance. Tools fail silently or with generic shell errors (e.g., 'jq: parse error'). No recovery hints for LLMs when a call fails.