Get started

Codex Cloud

Install finoctl in your cloud workspace and approve access from your phone.

Install in the target chat

Attach the release ZIP to the Codex Cloud chat that needs access. Ask the assistant to extract it, check the manifest, and run install.sh with Node.js 24 or newer. It can do this in the background.

Use a private session directory for the target environment. Run the commands with these settings in every new shell or tool process. If the session already shows the correct authenticated account, keep it and verify a product read.

Terminal

export PATH="$HOME/.local/bin:$PATH"
export FINO_CREDENTIAL_STORE=file
export FINO_SESSION_DIR="$HOME/.finoctl-cloud"
finoctl --version
finoctl wholesale status

Start the connection

When the account owner is ready, have the assistant run this command with the same environment settings and keep it running.

Terminal

finoctl wholesale login --browser --name "Codex Cloud wholesale"

The assistant can share the generated approval URL, public connection code, and connection name. Open the link, sign in on the wholesale site, match the code and name, and tap Approve CLI. Each request lasts ten minutes.

Verify the saved session

Ask the assistant to start a new process with the same session directory after approval.

Terminal

finoctl wholesale status
finoctl wholesale products list --page 0

Verify the account identity and a successful product read. A replacement cloud workspace needs its own installation and approval if it lacks the original private session directory.

Copy a prompt for Codex Cloud

Text

Install finoctl from the attached ZIP and follow CLOUD-BROWSER-LOGIN.md.
Use a private session directory in this workspace. If my account is
already signed in, verify status and read the first product page.
If it needs a new sign-in, wait for me to say I'm ready, then run
finoctl wholesale login --browser --name "Codex Cloud wholesale"
in the background and show me the approval link and matching code.
After approval, use a new process to verify the saved session and
read the first product page.