claude-personas

Persona-based organization system for Claude Code. One command to scaffold, configure, and launch specialized AI agent environments.

Quick Start

npx claude-personas

This runs the interactive setup (secrets wizard + full install).

Commands

| Command | Description | |---------|-------------| | npx claude-personas | Full setup (init + install) | | npx claude-personas init | Interactive secret configuration | | npx claude-personas install [--force] | Scaffold directories, symlinks, MCP configs | | npx claude-personas open <persona> | Launch persona in a new terminal | | npx claude-personas ls | List personas with install status | | npx claude-personas status | Diagnose installation health |

Personas

| Shortcut | Persona | Description | |----------|---------|-------------| | res | researcher | Investigation, analysis, data collection | | brain | brainstormer | Idea generation, creative exploration | | plan | planner | Project planning, spec writing | | ui | ui-ux-designer | UI/UX design, prototyping | | fe | frontend-dev | React/Next.js frontend | | 3d | 3d-web-frontend | Three.js/R3F 3D web games | | be | backend-dev | API, DB, server logic | | infra | infra | DevOps, CI/CD, deployment | | mkt | marketer | Marketing strategy, content | | write | writer | Technical docs, copywriting | | create | creator | Video production, creative content | | 3dm | 3d-modeler | 3D modeling, asset optimization | | qa | qa | E2E testing, quality assurance | | n8n | n8n-automator | N8N workflow automation |

How It Works

1. init asks for your API keys/tokens via interactive prompts and saves them to .env
2. install creates the directory structure:
   • ~/.claude/ — global settings, commands, skills
   • ~/.agents/skills/ — 22 shared skill definitions
   • ~/claude-space/<persona>/ — per-persona directory with .claude/skills/ symlinks, .mcp.json, and rules
3. open launches a new terminal window at the persona directory and starts claude

Each persona gets only the MCP servers and skills it needs, keeping context windows lean.

Terminal Support

Supports 14+ terminal emulators across macOS, Linux, WSL, and Windows:

• macOS: Ghostty, iTerm2, Terminal.app
• Linux: Ghostty, Kitty, Alacritty, WezTerm, GNOME Terminal, Konsole, Xfce4 Terminal, xterm
• Windows/WSL: Windows Terminal, Git Bash, MinTTY

Override with CS_TERMINAL=kitty npx claude-personas open fe.

Environment Variables

| Variable | Description | |----------|-------------| | CS_TERMINAL | Force a specific terminal emulator | | CS_CLAUDE_ARGS | Override claude args (default: --dangerously-skip-permissions) |

License

MIT