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
-
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 -
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.
-
Start another chat, open
/hooksor Settings → Hooks, review and trust the ConsoleX hooks, then run$consolex-login. Approve the matching code in your browser.$consolex-statuschecks 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.
- 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
| Command | What it does |
|---|---|
$consolex-login | Connect this computer |
$consolex-status | Show the connection and the tasks added here |
$consolex-tasks | List or search your tasks |
$consolex-start | Start a task in this chat |
$consolex-add, $consolex-remove | Add or remove a task's $cx-… shortcut |
$consolex-save | Save this session as a task |
$consolex-schedule | Schedule a task in the Codex app |
$consolex-logout | Disconnect 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-statusand$consolex-tasksto check the account and address. For an expired browser code, run$consolex-loginagain. - 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.