personal-squad
User-level AI agents that travel with you across projects
- License 许可
- MIT
- 所属仓库
- github/gh-aw
- 最近更新
- 2026-11-15
- Stars
- ★ 5.6k
- Forks
- 626
01 前言 Front Matter
- name
- personal-squad
- domain
- configuration
- source
- manual
- confidence
- medium
- description
- User-level AI agents that travel with you across projects
03 SKILL.md 正文
Personal Squad — Skill Document
What is a Personal Squad?
A personal squad is a user-level collection of AI agents that travel with you across projects. Unlike project agents (defined in a project's .squad/ directory), personal agents live in your global config directory and are automatically discovered when you start a squad session.
Directory Structure
~/Library/Application Support/squad/personal-squad/ # macOS
~/.config/squad/personal-squad/ # Linux
%APPDATA%/squad/personal-squad/ # Windows
├── agents/
│ ├── {agent-name}/
│ │ ├── charter.md
│ │ └── history.md
│ └── ...
└── config.json # Optional: personal squad config
How It Works
- Ambient Discovery: When Squad starts a session, it checks for a personal squad directory
- Merge: Personal agents are merged into the session cast alongside project agents
- Ghost Protocol: Personal agents can read project state but not write to it
- Kill Switch: Set
SQUAD_NO_PERSONAL=1to disable ambient discovery
Commands
squad personal init— Bootstrap a personal squad directorysquad personal list— List your personal agentssquad personal add {name} --role {role}— Add a personal agentsquad personal remove {name}— Remove a personal agentsquad cast— Show the current session cast (project + personal)
Ghost Protocol
See templates/ghost-protocol.md for the full rules. Key points:
- Personal agents advise; project agents execute
- No writes to project
.squad/state - Transparent origin tagging in logs
- Project agents take precedence on conflicts
Configuration
Optional config.json in the personal squad directory:
{
"defaultModel": "auto",
"ghostProtocol": true,
"agents": {}
}
Environment Variables
SQUAD_NO_PERSONAL— Set to any value to disable personal squad discoverySQUAD_PERSONAL_DIR— Override the default personal squad directory path
04 同仓库更多 Skills
cracktro
Edit, preview, and verify the standalone interactive talk deck in docs/public/cracktro (slides, SVG diagrams, transitions, WebAudio sound).
create-connector
Create or extend a declaration-only third-party connector, with narrow reads, separate safe outputs, optional protected triggers, and offline conformance evidence.
GitHub Agentic Workflows
GitHub Agentic Workflows (`gh-aw`) is a GitHub CLI extension for writing Agentic Workflows in markdown and compiling them to GitHub Actions.
windows-compatibility
Cross-platform path handling and command patterns
versioning-policy
Semver versioning rules for Squad SDK and CLI — prevents prerelease version incidents
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for context reduction per spawn