coding-agent

Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent as background PTY processes.

46|6|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/aresbit/MateBot --skill coding-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coding-agent
Source: https://github.com/aresbit/MateBot/tree/main/skills/coding-agent
Command: npx skills add https://github.com/aresbit/MateBot --skill coding-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables programmatic control of coding agents by running Codex CLI, Claude Code, OpenCode, or Pi Coding Agent as background processes.

Core Features & Use Cases

  • PTY-backed interactive sessions to ensure terminal behavior for coding agents.
  • Background task orchestration to launch, monitor, and manage long-running agent work across projects.
  • Session management commands (list, poll, log, write, submit, send-keys, paste, kill) for script-driven control.
  • Use Case: Automate multi-project coding tasks without manual intervention.

Quick Start

Use a PTY-enabled background session to run a coding agent, e.g.: bash pty:true workdir:~/project background:true command:"codex exec 'Build a feature'"

Frequently Asked Questions about coding-agent

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

FAQPage Schema
How do I run coding agents as background processes for long-running tasks?

To run coding agents as background processes, you can use PTY-enabled sessions to execute tools like Codex CLI or Claude Code. This allows long-running coding tasks to operate in the background with session monitoring and optional workdir scoping.

Can I manage interactive PTY sessions for CLI coding agents programmatically?

Yes, you can manage interactive PTY sessions programmatically. The Skill exposes background process actions such as list, poll, log, write, submit, send-keys, paste, and kill to control CLI coding agents via script-driven commands.

Does background coding agent orchestration work with Codex CLI and Claude Code?

Background coding agent orchestration works with Codex CLI, Claude Code, OpenCode, and Pi Coding Agent. It requires PTY-enabled terminals to ensure proper terminal behavior for these interactive coding agents during execution.

How do I automate multi-project coding tasks without manual intervention?

You can automate multi-project coding tasks by launching PTY-backed background sessions with specific workdir parameters. Use session management commands to monitor progress, send inputs, and manage agent work across projects without manual intervention.

What are the limitations of running coding agents in background PTY sessions?

Background PTY sessions require PTY:true for all runs and depend on terminal behavior. While they support timeout and elevated configurations, interactive coding agents may have specific environmental requirements or constraints based on the selected CLI tool.

Why do I need a PTY-enabled terminal to control coding agents in the background?

A PTY-enabled terminal is required because coding agents like Claude Code and Codex CLI expect interactive terminal behavior. PTY ensures proper terminal emulation, allowing background processes to handle input, output, and session interactions correctly.