codex/skills/accts/SKILL.md
Manage local Codex account switching with a metadata-only TOML config, safe auth.json vault backups, pending manual account activation, and weekly reset-cycle rotation. Use when the user asks to manage Codex accounts, switch Codex accounts, inspect account status, or rotate through accounts after weekly limits reset.
npx skillsauth add tkersey/dotfiles acctsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use accts to manage multiple local Codex accounts without putting OAuth secrets in prompts, TOML, logs, or skill instructions. The skill owns only Codex CLI auth at ~/.codex/auth.json; do not extend it to Claude, Gemini, or unrelated agent CLIs.
The executable is:
python3 codex/skills/accts/scripts/accts.py --help
auth.json as secret OAuth material. Never print, summarize, paste, or store its contents outside the owner-only vault.accts.toml metadata-only. If TOML contains token-like keys such as access_token, refresh_token, api_key, secret, or password, stop and fix the config rather than tolerating it.CODEX_HOME and ACCTS_HOME for tests, dry runs, or examples unless the user explicitly wants to mutate the live account setup.queue, next, and explicit activate commands so account changes are visible user-owned steps.activate changes auth.json, but the running turn may already have loaded credentials. Prefer activating before starting the turn that should use the new account.Default config location:
python3 codex/skills/accts/scripts/accts.py init --dry-run
python3 codex/skills/accts/scripts/accts.py init
Config schema:
[settings]
# codex_home = "~/.codex"
# vault_dir = "~/.local/share/accts/vault"
# state_dir = "~/.local/share/accts/state"
# cas_cwd = "/path/to/repo"
[accounts.personal]
label = "Personal"
enabled = true
reset_participates = true
vault = "personal/auth.json"
Back up each account once:
python3 codex/skills/accts/scripts/accts.py backup personal --label "Personal"
python3 codex/skills/accts/scripts/accts.py ls
python3 codex/skills/accts/scripts/accts.py status
Switch immediately when no current turn depends on the old account:
python3 codex/skills/accts/scripts/accts.py activate personal --backup-current
Queue a switch, inspect the pending account, then activate it manually before the turn that should use it:
python3 codex/skills/accts/scripts/accts.py queue personal
python3 codex/skills/accts/scripts/accts.py next
python3 codex/skills/accts/scripts/accts.py activate personal --backup-current
Use reset-cycle rotation after the weekly Codex limit reset so each participating account receives one real turn near the same reset window.
python3 codex/skills/accts/scripts/accts.py reset-cycle status
python3 codex/skills/accts/scripts/accts.py reset-cycle start
python3 codex/skills/accts/scripts/accts.py next
reset-cycle start reads CAS account status and queues the first eligible vaulted account. Activate the account shown by next before using it. After that account has had a real turn, run reset-cycle advance --account <name> to mark it touched and queue the next untouched account. The cycle completes after every enabled reset_participates = true vaulted account has been marked touched.
If CAS is unavailable, do not invent reset timing. Use reset-cycle status --state-only to inspect local state, or ask the user before using an explicit offline --resets-at timestamp.
tools
Invokes Apple's macOS 27 fm command-line tool from a local Mac to use the on-device system model or Private Cloud Compute, including instructions, image prompts, schema-constrained JSON, and noninteractive automation. Use when the user asks to run Apple Foundation Models through fm, compare system versus pcc, generate structured output, or automate fm without Swift or an app.
development
Compile historical Codex sessions into governed counterfactual evidence, evaluate an existing owner-applied candidate through blinded paired HCTP trials, and fold observable evidence into RUN, OBSERVE, or STOP. Use for `$hylo`, CRF extraction, counterfactual replay, source-governed direct or historical trials, sealed evidence, paired baseline/candidate evaluation, causal frontiers, or evidence-governed improvement.
testing
Ensure a `ledger` command is available on PATH; materialize, validate, record, replay, and project requested Actuating artifacts without taking semantic or execution authority; coordinate the shared Learnings/Synesthesia/Negative Ledger lifecycle checkpoint and repo-local source-memory reconciliation; address Universalist plans and receipts; and perform pure artifact validation.
testing
Classify and quotient review findings, failing tests, incidents, bug reports, migration failures, and other witnessed falsifiers against accepted intent and the current Construction. Author counterexample-set/v1 without selecting repairs, counting review credit, or granting mutation.