Skip to content

LOCAL_ACCESS.md

Latest commit

 

History

History
91 lines (58 loc) · 1.69 KB

LOCAL_ACCESS.md

File metadata and controls

91 lines (58 loc) · 1.69 KB
Raw

Local access guide

This project is intended to run locally, not as a hosted public web service.

Installed local binary

A local source build can be installed at any path on your PATH, for example:

~/.local/bin/codex-switch

Check it with:

codex-switch --version

Expected repository line:

https://github.com/five0nit/codex-switch-secure

First run

Use the guided wizard:

codex-switch setup

For SSH/headless/WSL use:

codex-switch setup --device --alias main-pro

Run the TUI or CLI dashboard

codex-switch list
codex-switch tui
codex-switch-web

The browser dashboard opens at http://127.0.0.1:8787/ and includes the safe config.toml editor. Keep it bound to localhost.

Add/import accounts

Use a throwaway/test Codex account first if you are evaluating the tool.

Interactive OAuth login:

codex-switch login test-account

Import an existing Codex auth.json backup:

codex-switch import /path/to/auth.json test-account

Where data is stored

The tool stores its own profiles under:

~/.codex-switch/

Codex's live auth file remains:

~/.codex/auth.json

Never paste either file into chat, tickets, logs, screenshots, or GitHub issues.

Update policy

Runtime self-update is disabled in this security-focused fork. To update from source:

curl -fsSL https://raw.githubusercontent.com/five0nit/codex-switch-secure/master/scripts/install.sh | bash

Local hosting note

This project is primarily a CLI/TUI account manager. The optional local-web/ dashboard should bind to localhost only and must not be exposed publicly without adding authentication.