coding-agent

Run interactive coding agents in PTY-enabled background sessions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codex CLI and coding agents require an interactive terminal to work reliably; this skill enables running Codex, Claude Code, OpenCode, and Pi agents in PTY-backed background sessions, ensuring stable, reproducible workflows.

Core Features & Use Cases

  • PTY-enabled background sessions for interactive CLIs (codex, claude, opencode, pi) to run long tasks without blocking the main shell.
  • Workspace-scoped execution with optional workdir and session management to monitor, log, and control multiple agents.
  • Clear safety and usage rules, including enforced PTY usage and explicit tool selection, to prevent misconfigurations and unsafe automation.

Quick Start

Launch a PTY-enabled background coding session in your project directory and begin issuing interactive commands.

Frequently Asked Questions about coding-agent

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

FAQPage Schema
How do I run a coding agent in a background terminal session?

You can run a coding agent in a background terminal session by launching it within a PTY-enabled environment, which allows interactive CLIs to execute long tasks without blocking your main shell.

Can I manage multiple coding agent sessions across different project directories?

Yes, you can manage multiple coding agent sessions across different project directories using workspace-scoped execution, which provides optional workdir configuration to monitor, log, and control concurrent agents.

Does running Claude Code or Codex CLI require an interactive terminal?

Running Claude Code or Codex CLI requires an interactive terminal to work reliably, but you can satisfy this requirement by using PTY-backed background sessions for stable, reproducible workflows.

How do I ensure safe and auditable automation when scripting coding agents?

You ensure safe and auditable automation by enforcing strict PTY usage and explicit tool selection, which prevents misconfigurations and unsafe automated actions during background execution.

What coding agents can I control with PTY-enabled background sessions?

You can control Codex, Claude Code, OpenCode, and Pi agents using PTY-enabled background sessions, ensuring stable and scriptable coding workflows across your local environments.

Why does my automated coding workflow fail when the main shell is blocked?

Automated coding workflows fail when the main shell is blocked because interactive CLIs require a persistent terminal connection, which PTY-backed background sessions provide to prevent execution interruption.