Codex-Managed-Agent VS Code Extension

Codex-Managed-Agent is a VS Code extension for managing Codex agent threads inside the editor.

It provides a native VS Code surface for:

What it does

This extension is currently a preview build intended for local and team workflows.

It works best when paired with the local codex_manager service that exposes thread and log data.

Start the local service:

cd <your-workspace>/codex_manager
source .venv/bin/activate
uvicorn codex_manager.app:app --reload --port 8787

Useful placement commands:

Notes:

The extension now also shows a left Activity Bar icon.
The editor tab can be opened in the center area, beside another editor, or moved to a new window.
The docked view can be opened in the Sidebar or the bottom Panel.
If you want it on the right side, drag the view container to the Secondary Side Bar or move the Side Bar position in VS Code.

If the server is not running, the extension will try to start it automatically when the panel opens.

codexAgent.baseUrl
- default: http://127.0.0.1:8787/
- point this to another port if your local dashboard runs elsewhere
codexAgent.autoStartServer
- default: true
- starts the local FastAPI service when the panel cannot connect
codexAgent.pythonPath
- optional override for the Python binary used to launch the server
codexAgent.serverRoot
- optional absolute path to the local codex_manager server root

Local installable package:

cd /path/to/codex-managed-agent
npx @vscode/vsce package

This produces a file like:

codex-managed-agent-0.0.2.vsix

Then install it in VS Code:

Typical release flow:

npx @vscode/vsce package
npx @vscode/vsce publish

Publishing requires: