Skip to main content

Use ConsoleX tasks in Codex

Codex can run a task on your computer while ConsoleX records the delivery and checks it against the saved standard when automatic checks are on. Connecting requires a paid plan. Codex uses its own model and account; ConsoleX checks and tool calls use your ConsoleX allowance or Credits.

Install and connect​

  1. Install Codex, Git and Python 3.9 or later. In ConsoleX, open Settings → Coding agents, select Codex, and copy the two commands to your terminal:

    codex plugin marketplace add EvalsOne/consolex-codex-plugin
    codex plugin add consolex@consolex-codex
  2. Start a new Codex chat and send a message once to finish setup. The plugin installs its hooks, command Skills and a local MCP server.

  3. Start another chat, open /hooks or Settings → Hooks, review and trust the ConsoleX hooks, then run $consolex-login. Approve the matching code in your browser. $consolex-status checks the connection.

If another ConsoleX address is this computer's default, run $consolex-login https://api.consolex.ai to select production.

Run and check a task​

Open Run on the task list or run history, choose Run in a coding agent…, select Codex, and paste the $consolex-start <task UUID> command into Codex. The UUID identifies the task even when names repeat.

Watch Codex turn three notes into a weekly brief. ConsoleX flags a missing TL;DR and then an unanswered question. The third delivery passes. Excerpts from a recorded demo session, with music and no narration.
  • For repeated use: $consolex-add <task UUID> adds a $cx-… shortcut for the task. Adding doesn't run it.
  • Stop a run: say "stop this task" in its Codex chat. The run ends as interrupted, without a delivery check.

When a delivery is handed in, Codex shows the verdict, and a passed check adds a receipt with a link to the run. Read the result and the check report in Run history. A failed or uncertain check waits for your decision unless automatic revision is on. See how a run is checked.

Save a session as a task​

Type $consolex-save [task name] in Codex. Open the review link, check the requirements, the Skill and the checks, then choose Create task. The task's shortcut is normally added to this computer after saving.

The task keeps its method in a local Skill and runs in Codex. To change how it works, edit the Skill; change the delivery goal, run rules and checks in ConsoleX. See the two kinds of tasks.

Run on a schedule​

In the Codex app, open the task's working folder and run the command from the task's run panel or settings, for example:

$consolex-schedule <task UUID> every weekday at 9:00

It adds the task locally if needed. Keep the app open at the scheduled time. Change or stop the schedule in Codex, and stop it there before scheduling the task anywhere else.

Commands​

CommandWhat it does
$consolex-loginConnect this computer
$consolex-statusShow the connection and the tasks added here
$consolex-tasksList or search your tasks
$consolex-startStart a task in this chat
$consolex-add, $consolex-removeAdd or remove a task's $cx-… shortcut
$consolex-saveSave this session as a task
$consolex-scheduleSchedule a task in the Codex app
$consolex-logoutDisconnect this computer

Troubleshooting​

  • Commands or hooks are missing: send a message in a new chat to finish setup, then open another new chat and review the ConsoleX hooks. Repeat the hook review after an update changes them.
  • The account or task is wrong: use $consolex-status and $consolex-tasks to check the account and address. For an expired browser code, run $consolex-login again.
  • A local Skill is missing: install the task's main Skill on this computer or run it where that Skill is available.
  • A ConsoleX tool is unavailable: check the task's tool permission and its required connections. Some tools and Skills cannot be used through the integration.

Update or uninstall. To update, run codex plugin marketplace upgrade consolex-codex, start a chat to refresh the installation, then review changed hooks in a new chat. To uninstall, run codex plugin remove consolex@consolex-codex, then python3 ~/.consolex/codex-integration/scripts/marketplace_installer.py --uninstall; your ConsoleX sign-in remains. Setup uses the standard ~/.consolex and ~/.agents/skills folders; use the standalone installer for custom CONSOLEX_HOME or CONSOLEX_SKILLS_DIR paths.

For limits and evidence, see Use tasks in a coding agent and How checks work.