Codex sessions

About

The Codex sessions you started in the Codex CLI, an IDE, or the Codex app: what each is doing, what it changed, and what is waiting on you. The execution agent can read a session, message it, stop a turn it started, answer its approvals, and start new sessions in folders you allow.

Tested by SidebudChecked on macOS against Codex 0.157.0: listed real sessions (metadata only), started a session in a temporary folder, messaged it, stopped a running turn, and answered a real command approval. The phone app and Windows are not checked yet.

On your phone

Made-up sample data, as your phone would show it. Tap the tile to open it.

9:41

Sidebud

Think. Speak. Get it done.

▭ Your computer

What it can do on your computer

4 tools read and 4 tools change things. Your computer only ever calls the tools listed here, and you can turn off any of them on the widget’s page after installing.

What it can control

Full control of your computer

Can control your whole computer. It starts agents or runs commands that can do anything you can there: open, change, and delete your files, use your apps and signed-in accounts, and install software.
Can change things with 4 tools, and reads with 4 tools.
Runs its own program on your computer as you while it is on. Sidebud decides which of its tools are called, not what that program itself can reach.

Tool	Access	Used by
`list_sessions` Recent Codex sessions by folder, and which are running or waiting on you	Reads	widget data (sessions)
`read_session` A session's latest messages and turn	Reads	opening a row
`get_diff` The files a session's latest turn changed	Reads	Your agent, when you ask
`list_pending` Approvals waiting on you, for turns this pack started	Reads	widget data (pending)
`send_message` Send a message to a session	Changes things	Your agent, when you ask
`start_session` Start a session in an allowed folder	Changes things	Your agent, when you ask
`stop_session` Stop a turn this pack started	Changes things	Your agent, when you ask
`respond_pending` Answer an approval	Changes things	Your agent, when you ask

A tool you turn off is never called: not by the widget, a control, or your agent. Tools that change things act in the app or service the widget connects to, when you or your agent use them.

What it runs

node server/index.mjs

A small server that comes with this widget, run by the companion with Node.js when the widget is on. You can read its code in the pack.

It receives: CODEX_HOME, CODEX_COMMAND, CODEX_SESSIONS_MODEL, CODEX_SESSIONS_FOLDERS.

Keys and accounts

No keys or sign-in.

Keys and tokens are saved in your computer’s keychain. They never go to Sidebud.

Network

None declared beyond what it runs.

Setting it up

Install Codex 0.157 or later and sign in (codex --version, then codex login).
Nothing else is needed to see and message sessions. To let the execution agent start new sessions, set Allowed folders to the project folders it may use.

Add it from the app

About

On your phone

Details

What it can do on your computer