Shared configuration for pi and OpenCode AI coding agents.
.
├── 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
./install.shThis symlinks:
coding/AGENTS.md→~/.pi/agent/AGENTS.mdpi/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"
]
}| Skill | Triggered By |
|---|---|
jira-taskwarrior-workflow |
"specjira", "createtasks", "implement", Jira IDs |
code-reviewer |
After code changes, "review my code" |
test-diagnostician |
"run tests", "tests failing" |
pr-reviewer |
"PR #123", "review this PR" |
pr-summary |
"pr summary", "create pr" |
git-commit-helper |
"commit", "git commit" |
gh |
GitHub CLI operations |
Some configs reference environment variables. Set these in your shell:
| Variable | Used By |
|---|---|
GRAFANA_SERVICE_ACCOUNT_TOKEN |
MCP: Grafana |
HONCHO_API_KEY |
MCP: Honcho |
- Never commit
auth.json,.env, sessions, or any tokens - The
.gitignoreblocks these automatically global/opencode.jsonuses${VAR}syntax for secrets — set them in your environment
| Document | Description |
|---|---|
docs/humanlayer-pi-workflow.md |
End-to-end workflow guide for HumanLayer + Pi agent integration |
This repo is the source of truth. Edit files here, then re-run ./install.sh or let the symlinks pick up changes automatically.