#AI Agent Configs

Shared configuration for pi and OpenCode AI coding agents.

#Structure

.
├── pi/                          # Pi-native configs
│   ├── skills/                  # Pi skills (auto-load on context match)
│   │   ├── jira-taskwarrior-workflow/
│   │   ├── code-reviewer/
│   │   ├── test-diagnostician/
│   │   ├── pr-reviewer/
│   │   ├── pr-summary/
│   │   ├── git-commit-helper/
│   │   └── gh/
│   └── prompts/                 # Pi prompt templates (/name)
│       └── sonar.md
├── global/                      # OpenCode shared config
│   ├── opencode.json            # Providers, models, MCP servers
│   ├── skills/
│   │   └── marpit-slides/
│   ├── themes/
│   └── tools/
├── coding/                      # OpenCode coding workflow
│   ├── AGENTS.md                # Project coding guidelines (loaded by pi)
│   ├── skills/                  # OpenCode skills
│   │   ├── taskwarrior/
│   │   ├── tdd-workflow/
│   │   ├── security-review/
│   │   ├── coding-standards/
│   │   ├── gh-unresolved-comments/
│   │   ├── playwright/
│   │   └── acli/
│   ├── commands/                # OpenCode prompt templates (commands)
│   │   ├── implement.md
│   │   ├── createtasks.md
│   │   ├── specjira.md
│   │   ├── git.md
│   │   ├── test.md
│   │   └── ...
│   └── agent/                   # OpenCode prompt templates (agents)
│       ├── code-reviewer.md
│       ├── debugger-ts.md
│       └── ...
├── obsidian/                    # OpenCode for Obsidian agent client
├── general/                     # OpenCode general-purpose config
└── install.sh                   # One-shot symlink installer

#Quick Start

./install.sh

This symlinks:

• coding/AGENTS.md → ~/.pi/agent/AGENTS.md
• pi/prompts/* → ~/.pi/agent/prompts/
• global/ → ~/.config/opencode/

Skills are loaded by adding paths to ~/.pi/agent/settings.json (see below) — no symlinks needed.

Then add to ~/.pi/agent/settings.json:

{
  "skills": [
    "~/Code/salaryhero/opencode/pi/skills",
    "~/Code/salaryhero/opencode/global/skills",
    "~/Code/salaryhero/opencode/coding/skills",
    "~/.config/opencode/skills"
  ],
  "prompts": [
    "~/Code/salaryhero/opencode/coding/commands",
    "~/Code/salaryhero/opencode/coding/agent"
  ]
}

#Pi Skills

#Environment Variables

Some configs reference environment variables. Set these in your shell:

#Security

• Never commit auth.json, .env, sessions, or any tokens
• The .gitignore blocks these automatically
• global/opencode.json uses ${VAR} syntax for secrets — set them in your environment

#Documentation

#Updating

This repo is the source of truth. Edit files here, then re-run ./install.sh or let the symlinks pick up changes automatically.