Metadata-Version: 2.4
Name: shypmate
Version: 0.2.1.dev29
Summary: Build, manage, and deploy AI agent teams across your projects
Author-email: Paul R <paulr978@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://shypmate.dev
Project-URL: Documentation, https://docs.shypmate.dev
Project-URL: Repository, https://github.com/paulr978/shypmate
Project-URL: Issues, https://github.com/paulr978/shypmate/issues
Keywords: ai,agents,ai-team,claude,claude-code,skills,developer-tools,dev-agents,llm,personas
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1.7
Requires-Dist: httpx>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: rich>=13.7.0

# 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](https://shypmate.dev) dashboard.

## Quick start

```bash
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](https://pipx.pypa.io), 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:

```bash
# 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:**

```bash
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

```bash
# 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](https://shypmate.dev)
- Docs: [docs.shypmate.dev](https://docs.shypmate.dev)
- GitHub: [github.com/paulr978/shypmate](https://github.com/paulr978/shypmate)
