Personal AI infrastructure for managing multiple AI coding tool configurations using GNU Stow.

Atlas symlinks dotfiles/configs to their expected system locations:

• claudecode/.claude/ → ~/.claude/ (Claude Code)
• opencode/.config/opencode/ → ~/.config/opencode/ (OpenCode)

Supports three AI coding agents: Claude Code, OpenCode, and Gemini CLI.

Based on PAI (Personal AI Infrastructure) by Daniel Miessler.

Atlas integrates patterns from three complementary systems:

Installed as a Claude Code plugin at ~/.claude/plugins/cache/superpowers/. Provides 14 engineering discipline skills:

• TDD — Iron Law test-driven development with rationalization counters
• Systematic Debugging — 4-phase root cause analysis with find-polluter.sh
• Verification Before Completion — No claims without fresh evidence
• Two-Stage Code Review — Spec compliance THEN code quality
• Brainstorming — Socratic one-question-at-a-time design refinement
• Writing/Executing Plans — Bite-sized tasks with exact file paths
• Git Worktrees — Isolated workspace creation
• Subagent-Driven Development — Fresh context per task

Seven patterns cherry-picked and implemented natively in Atlas (no GSD runtime dependency):

# Install Atlas (creates symlinks)
make install

# Or manually stow packages
make stow pkg=claudecode
make stow pkg=opencode

atlas/
├── claudecode/               # Claude Code package
│   └── .claude/
│       ├── skills/           # 38 PAI skills + skills.sh integrations
│       ├── plugins/          # Superpowers v4.1.1 (14 skills)
│       ├── hooks/            # 16 lifecycle event handlers
│       ├── agents/           # 12 named agent definitions
│       ├── Commands/         # Slash commands (/commit, /push, etc.)
│       ├── Observability/    # Agent monitoring dashboard
│       ├── VoiceServer/      # TTS notification server
│       └── MEMORY/           # Persistent state
│
└── opencode/                 # OpenCode package
    └── .config/opencode/
        ├── agent/
        ├── command/
        └── skill/

Real-time monitoring dashboard for Claude Code agent activity.

• Live event timeline with auto-scroll
• Multi-agent swim lanes
• Activity intensity visualization
• Event filtering (agent, type, session)
• Theme customization
• Background task monitoring

Via Slash Command:

/observability start   # Start dashboard
/observability open    # Start and open browser
/observability stop    # Stop dashboard

Via MenuBarApp (macOS):

Install the native menu bar app for convenient dashboard control:

cd claudecode/.claude/Observability/MenuBarApp
./build.sh

This installs Observability.app to /Applications/. Features:

• Menu bar status indicator (eye icon)
• Start/Stop/Restart controls
• Open Dashboard button
• Launch at Login toggle

Manual:

~/.claude/Observability/manage.sh start
open http://localhost:5172

See claudecode/.claude/Observability/CLAUDE.md for detailed documentation.

Atlas integrates with skills.sh (by Vercel Labs) for installing community and official agent skills. Skills.sh is a package manager for the open Agent Skills ecosystem.

Atlas uses a hybrid approach:

• PAI skills (CORE, Algorithm, etc.) are real directories in the Atlas repo, managed by Stow
• skills.sh skills are symlinks in ~/.claude/skills/ pointing to ~/.agents/skills/, installed via bunx skills
• .gitignore excludes skills.sh symlinks so they don't pollute the repo

Install curated skill bundles for any project with one command:

All installers target three agents simultaneously (claude-code, opencode, gemini-cli), show the skill list before installing, and wait for confirmation.

# Search for skills
bunx skills find <query>

# Install a specific skill
bunx skills add <owner/repo> --skill <name> -a claude-code -a opencode -a gemini-cli

# Install globally (all projects)
bunx skills add <owner/repo> --skill <name> -g -y

# List installed skills
bunx skills list -g

# Check for updates
bunx skills check

After installing new skills.sh skills globally, add their names to .gitignore under the # skills.sh managed skills section so they don't appear in git status.

make help           # Show all commands
make install        # Bootstrap Atlas
make run            # Symlink all packages
make stow pkg=NAME  # Symlink specific package
make unstow pkg=NAME # Remove specific symlink
make update         # Re-stow all packages
make delete         # Remove all symlinks
make status         # Check symlink status
make deps           # Install dependencies

• GNU Stow - Symlink farm manager
• Bun - JavaScript runtime (for hooks/server)
• Xcode CLI - For MenuBarApp build (macOS)

MIT