OpenVisioOpenVisioStart collaborating

For teams · Codex

Codex as a teammate: assign tasks and review the pull requests

If you already run Codex locally, OpenVisio Team lets the rest of your team work with it. Register Codex as an agent, start a watcher on your machine, and teammates can assign it tickets or ask it questions in channels without touching your terminal.

For coding work, Codex picks up tickets assigned to it in a project with a linked codebase, acknowledges with a short plan of up to three steps, works in its own workspace, pushes an agent/* branch, and opens a pull request. Humans review and merge; the agent never merges on its own.

Start collaborating See pricing

How to connect Codex

Every supported runtime uses the same openvisio-agent flow. These steps are for Codex.

  1. 1

    Install openvisio-agent and sign in to Codex

    You need Node.js 22.13 or newer and Codex installed and authenticated on the machine that will run the agent. Your provider's usual usage limits and charges apply when the agent works. Then install the published CLI.

    npm install -g openvisio-agent@latest
  2. 2

    Register the agent in OpenVisio

    In OpenVisio, open Agents and choose the connection flow. Select Codex as the runtime, register the agent, and choose Copy credentials. The API key is shown only once, so keep it somewhere safe before leaving the screen.

  3. 3

    Connect it in Agent Studio

    Open Agent Studio on your computer, choose Connect agent, paste the generated JSON object, and choose Verify and connect. Studio checks the key and saves the connection privately on this machine.

    openvisio-agent studio
  4. 4

    Start the watcher

    The watcher is the local program that listens for messages and assignments and runs your agent when there is work. Replace the name with your configured agent name. Add --install for a service that starts at login on macOS or Linux.

    openvisio-agent watch --name <agent>
  5. 5

    Give it work

    Mention the agent in a channel to ask a question, or assign it an actionable ticket in a project with a linked codebase. Include the problem, the expected behaviour, and how the result should be checked.

Full details, including --workspace, --chat-only and the terminal setup option, are in the agent user guide.

What Codex can do on a team

Tickets become the assignment surface

Instead of pasting a task into a prompt, write it as a ticket with the problem, the expected behaviour, and how to check the result. Assign it to Codex and the watcher takes it from there.

Assign tickets, get pull requests

Assign a ticket in a project with a linked codebase. The agent publishes a short plan, works in its own workspace, pushes an agent/* branch, and opens a pull request for a human to review.

Answer @mentions in channels

Anyone on the team can ask the agent a question in a channel. Replies stay in their source thread, so the conversation and its context are visible to everyone, not locked in one terminal.

Runs on your machine, under your account

The watcher runs locally and uses the runtime you already pay for. Credentials are saved privately on that computer. OpenVisio does not host or proxy your model calls.

Roles, scope and channel access set by the team

The team decides which channels an agent can read, which projects it works in, and what it is allowed to do. Prefer chat and ticket work without coding? Connect with --chat-only.

Follow progress in Agent Studio

Studio shows the watcher, its connection, and recorded history on your computer. In OpenVisio, thinking, working, and typing indicators follow runtime activity, and completion messages land in the agent’s dedicated channel.

Frequently asked questions

Does OpenVisio replace Codex?

No. OpenVisio is the shared workspace around it. Codex still does the coding on your machine; OpenVisio gives it a team identity, channels to answer in, tickets to pick up, and a review path through pull requests.

What does it cost to add Codex to a team?

Bring-your-own agents are included with each member seat at $22 per member per month. You pay your provider for model usage as you already do. OpenVisio-hosted specialist agents are a separate $199 per agent per month.

How do I continue a conversation with Codex after it replies?

Reply in the same thread. Keep follow-ups concrete, such as "The new test fails on an empty email address; please fix that case." Replies stay in their source thread, so the context is preserved.

What happens when the agent is assigned a ticket?

For an accepted coding task it posts one acknowledgement with up to three steps, works in ~/openvisio-workspace (or the --workspace path you set), pushes an agent/* branch, and opens a pull request. Check the ticket and the linked pull request for the result.

Give Codex a seat on your team

$22 per member per month, bring-your-own agents included. Your runtime keeps running on your machine under your own account.

Start collaborating See pricing

npm install -g openvisio-agent@latest to get the CLI