shypmate 0.2.1.dev29

Build, manage, and deploy AI agent teams across your projects

shypmate

Build, manage, and deploy AI agent teams across your projects.

Create named AI personas with distinct skills and personalities, deploy them as Claude Code slash commands, and let them accumulate memory across sessions. Manage everything through a CLI or the shypmate.dev dashboard.

Quick start

pipx install shypmate               # install once per machine (see Install below)
shypmate auth login                 # one-time auth, writes ~/.shypmate/config.json
cd ~/projects/my-app
shypmate init                       # register this repo with shypmate
claude /terry "Implement the login screen"

Install

shypmate is a machine-global CLI — install it once per machine, not per project. The recommended installer is pipx, which isolates shypmate in its own venv but puts shypmate on your PATH so you can run it from any directory.

First, install pipx if you don't have it yet:

# Windows
python -m pip install --user pipx
python -m pipx ensurepath       # then close and reopen your terminal

# macOS
brew install pipx
pipx ensurepath

# Linux
sudo apt install pipx           # or your distro equivalent
pipx ensurepath

Then install shypmate:

pipx install shypmate

To upgrade later: pipx upgrade shypmate.

If you previously installed shypmate inside a project's venv with pip install shypmate, uninstall that copy (pip uninstall shypmate in the venv) so the global pipx version takes over — nothing else to clean up.

Plain pip install shypmate still works, but pins shypmate to whichever Python environment you run it from. That's fine for one-off experiments but breaks the "run shypmate up from anywhere" model for managing multiple projects at once.

Commands

# Auth
shypmate auth login              # Authenticate with shypmate.dev
shypmate auth status             # Check auth status
shypmate auth logout             # Remove credentials

# Project setup
shypmate init                    # Initialize shypmate in current project
shypmate sync                    # Sync agents and playbook from shypmate.dev

# Team management
shypmate hire "qa"               # Hire by role shortcut
shypmate hire "senior backend engineer with postgres expertise"
shypmate fire terry --archive    # Archive an agent (reversible)
shypmate rehire terry            # Reinstate an archived agent
shypmate roster                  # Detailed team roster
shypmate team list               # Quick agent list

# Memory
shypmate memory list             # List all memory entries
shypmate memory show terry       # Show an agent's memory
shypmate memory search "drizzle" # Search across all memory

Role shortcuts

Shortcut	Role
qa	Senior QA Engineer
frontend	Senior Frontend Engineer
backend	Senior Backend Engineer
devops	Senior DevOps Engineer
security	Security Engineer
mobile	Senior Mobile Engineer
data	Data Engineer
writer	Technical Writer
architect	Solutions Architect
designer	UI/UX Designer
fullstack	Senior Full-Stack Engineer
lead	Technical Lead

How it works

1. shypmate.dev stores your agent personas, shared playbook, and memory centrally
2. shypmate init syncs agents to your local ~/.claude/skills/ as Claude Code slash commands
3. Agents read/write memory via the shypmate API on session start/end
4. The playbook defines shared behavior for all agents — update it once, all agents get the update

What goes where

Location	Contains	Committed?
~/.shypmate/config.json	API key	Never
~/.claude/skills/{name}/	Agent SKILL.md files	No (auto-synced)
.shypmate/config.json	Project ID, agent list	Yes
.shypmate/project-context.md	Stack and architecture notes	Yes
shypmate.dev	Personas, playbook, memory	Cloud

Links

• Dashboard: shypmate.dev
• Docs: docs.shypmate.dev
• GitHub: github.com/paulr978/shypmate