Skip to content

Codex Project Management and Local Agent Missions

Queue coding work as project cards, run Codex on the machine that owns the repository, and keep mission progress, questions, failures, and results visible to the team.

Codex · connected local CLI

Codex

Connected

Stellary

Launch workspace

Ready
Project context
Prepare release mission
Activity
Identity, project, and tools remain scoped

Move a Codex session into a project workflow

Stellary turns a card into the operating envelope around the Codex run: project, repository, context, expected result, ownership, and review.

  1. 01

    Authenticate

    Install and sign in to Codex on the target machine.

  2. 02

    Detect

    Refresh Stellary Desktop until the Codex runner and models are ready.

  3. 03

    Link

    Connect the project to the exact local repository folder.

  4. 04

    Run

    Assign the card to the agent configured with the Codex target.

  5. 05

    Inspect

    Read the mission trace and review the delivered result.

Mission STL-128

Install and sign in to Codex on the target machine.

Running

Checklist

Detect
Link
Run

Linked context

project-brief.md

A project-repository link tells the runner where the coding mission belongs.

Run mission

The repository and the project stay connected

Codex works locally while Stellary remains the shared source for the card, project context, execution state, and team review.

Exact working repository

A project-repository link tells the runner where the coding mission belongs.

Workspace model visibility

Only ready models shared with the workspace are available to other members and agents.

Mission lifecycle

Queued, running, blocked, failed, cancelled, and completed states stay explicit.

Optional MCP configuration for Codex

TOML
[mcp_servers.stellary]
url = "https://api.stellary.co/mcp"

[mcp_servers.stellary.http_headers]
Authorization = "Bearer YOUR_TOKEN"

Use the Desktop runner for code changes

Codex needs a machine with the CLI installed, authenticated, and visible to the workspace. Stellary Desktop advertises that runner and claims eligible missions for the configured agent.

The project’s repository link prevents a card from being executed in an arbitrary folder. If the target is unavailable, the mission must remain visibly pending or fail with a readable reason.

Keep planning and review outside the terminal

The terminal is an execution surface, not the shared project record. The card keeps scope, documents, acceptance criteria, questions, and final review accessible to the rest of the team.

This also lets another agent or human reviewer continue from the same mission history.

Codex alone or Codex inside Stellary?

Source of work

Standalone Codex session

A prompt entered in the current terminal.

Stellary-managed mission

A card with owner, context, and success criteria.

Repository

Standalone Codex session

Current working directory.

Stellary-managed mission

Repository explicitly linked to the project.

Status

Standalone Codex session

Known by the terminal user.

Stellary-managed mission

Visible from the board and Activity.

Review

Standalone Codex session

Coordinated separately.

Stellary-managed mission

Attached to the original card and mission.

Questions about Codex and Stellary

Does Stellary include the Codex model?

Stellary connects to the Codex CLI installed and authenticated on your machine. Availability and model choices depend on that local runner and what the workspace shares.

Can several projects use the same machine?

Yes, provided each project is linked to the correct repository and the machine is authorized and available. The runner receives the mission with its project target.

Can I stop a local Codex mission?

Mission cancellation is part of the execution lifecycle. The runtime must honor the cancellation and return a visible state to Stellary.

Can Codex also use Stellary through MCP?

Yes, when the Codex client supports a remote MCP server with authorization headers. MCP is best for workspace tools; Desktop is best for execution in the linked local repository.

Give Codex a card the team can follow

Link one repository and run the first bounded coding mission from Stellary.

Create your first mission