coding-agent

Run Codex CLI, Claude Code, OpenCode, or Pi coding agents via background PTY processes.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ZaxbyHub/ragappv3 --skill coding-agent-zaxbyhub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coding-agent
Source: https://github.com/ZaxbyHub/ragappv3/tree/main/.claude/skills/coding-agent
Command: npx skills add https://github.com/ZaxbyHub/ragappv3 --skill coding-agent-zaxbyhub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interactive coding agent CLIs like Codex, Claude Code, OpenCode, and Pi require a pseudo-terminal and careful process management to run programmatically; without PTY and background session handling, output breaks, agents hang, and long-running tasks become impossible to monitor. ## Core Features & Use Cases - PTY-Based Execution: Run any supported coding agent with pty:true so interactive terminal output renders correctly and agents do not hang. - Background Session Management: Launch agents in background mode, then monitor with process actions like log, poll, submit, and kill. - Parallel Workflows: Review multiple PRs or fix multiple issues concurrently using git worktrees and one agent per task. - Use Case: Spawn Codex with --full-auto in a project directory to build a feature in the background, poll its log for progress, and receive an automatic completion notification via an OpenClaw system event. ## Quick Start Ask the agent to run Codex in your project directory with PTY and background mode enabled, for example: start Codex in ~/project to build a dark mode toggle and notify me when it finishes.

Frequently Asked Questions about coding-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Codex CLI programmatically in the background?▼

Run Codex with bash using pty:true, background:true, and a workdir pointing at your project, for example codex exec --full-auto 'your task'. The call returns a sessionId you can monitor with process log and poll actions.

Why does my coding agent hang or produce broken output?▼

Coding agents like Codex, Claude Code, and Pi are interactive terminal applications that require a pseudo-terminal. Always set pty:true when launching them; without PTY, output breaks, colors disappear, or the agent hangs.

How do I review multiple pull requests in parallel with Codex?▼

Fetch all PR refs, then launch one background Codex process per PR with pty:true, each reviewing a diff like origin/main...origin/pr/86. Monitor all sessions with process list and post results back with gh pr comment.

Why does Codex refuse to run in my directory?▼

Codex requires a trusted git repository and refuses to run outside one. For scratch work, create a temp directory with mktemp -d, run git init inside it, then execute your Codex command there.

How do I send input to a running coding agent session?▼

Use the process submit action with the sessionId to send text plus a newline, like typing and pressing Enter. Use write for raw data without a newline, and send-keys for special key tokens.

How do I get notified when a background coding agent finishes?▼

Append an instruction to the agent's prompt telling it to run openclaw system event --text "Done: summary" --mode now when finished. This triggers an immediate wake event instead of waiting for the next heartbeat.