feat: ship the programa agent skill (SKILL.md + installer wiring) - #173
Merged
Conversation
Teaches agents running inside programa (Claude Code, Codex, OpenCode) that they can drive the app itself via the socket-backed CLI: inspect the window/workspace/pane/surface tree, split panes and run commands without stealing the user's focus, read a sibling pane's output, spawn and coordinate a helper agent, and wait on it (poll or wait-for; a first-class wait primitive is tracked separately in #166 and isn't shipped yet). SKILL.md lives at the repo root, with a longer walkthrough at docs/agent-skill.md and a README pointer. The existing Claude/Codex/OpenCode install flows now drop it into each tool's standard skill location alongside their existing hooks/plugin file, using the same diff-then-confirm pattern already used for those: - Claude Code: ~/.claude/skills/programa/SKILL.md ($CLAUDE_CONFIG_DIR override) - Codex: ~/.agents/skills/programa/SKILL.md (the shared cross-tool convention) - OpenCode: ~/.config/opencode/skills/programa/SKILL.md ($OPENCODE_CONFIG_DIR override) OpenCode also discovers skills from ~/.claude/skills and ~/.agents/skills globally, so any one of the three installers already covers it for most setups. Refs #165
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Agents running inside programa now get taught how to drive the app.
SKILL.md(repo root) covers: env guard first (stop if not inside programa), inspecting surroundings, splitting/running without focus theft, reading sibling panes, spawning a helper agent, and waiting — including the freshly-landedwait-surface.Install flows drop the skill where each tool discovers it:
programa claude install-integration→~/.claude/skills/programa/SKILL.mdprograma codex install-hooks→~/.agents/skills/programa/SKILL.mdprograma opencode install-integration→~/.config/opencode/skills/programa/SKILL.mdAll three use the existing diff-preview-then-confirm flow; uninstall refuses to delete unmanaged files (marker check).
Test plan
programa+programa-clischemes buildFixes #165