# Acpx

> Use the ACPX CLI through DrClaw's existing exec/long_exec tools to run Codex in the current project workspace.

- Skill: `internscience/acpx` (Agent Skill)
- Install (CLI): `npx skillmds@latest add internscience/acpx`
- Raw SKILL.md: https://api.skillmd.com/api/skills/internscience/acpx/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: internscience (https://skillmd.com/u/internscience)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/internscience/acpx

---


# ACPX

Use this skill when you need Codex through the standard `acpx` CLI.

## Important

- In DrClaw, there is no dedicated ACPX tool.
- You must use the existing `exec` or `long_exec` tools to run `acpx` commands.
- Prefer `long_exec` unless the command is obviously short; ACPX turns can exceed the normal `exec` timeout.
- Run ACPX from the current project workspace or a subdirectory inside it.

## Recommended Workflow

### One-shot task

```bash
acpx codex exec '<instruction>'
```

Use this for a single request where you do not need follow-up turns.

### Persistent session

Create or recover a named session:

```bash
acpx codex sessions ensure --name drclaw-proj-<project-id>-<task-suffix>
```

Send a turn to that session:

```bash
acpx codex -s drclaw-proj-<project-id>-<task-suffix> '<instruction>'
```

Check status:

```bash
acpx codex -s drclaw-proj-<project-id>-<task-suffix> status
```

Cancel the current turn:

```bash
acpx codex -s drclaw-proj-<project-id>-<task-suffix> cancel
```

Close the session when it is no longer needed:

```bash
acpx codex sessions close drclaw-proj-<project-id>-<task-suffix>
```

## Session Discipline

- Reuse stable session names for ongoing tasks instead of creating duplicates.
- For sessions created by DrClaw project agents, always use the prefix `drclaw-proj-<project-id>-`.
- Before starting a new persistent session, check whether the same task already has one.
- If a command fails, first verify:
  - `acpx` is installed
  - you are in the intended workspace
  - the session name exists if using `-s`

## When To Use Which Tool

- Use `exec` only for very short ACPX commands.
- Use `long_exec` for `exec`, persistent sessions, or anything that may take more than a minute.