lilong7676/codex-pool
skills/codex-pool/SKILL.md
Manage multiple Codex CLI accounts with codex-pool, including checking 5h and 1week usage, switching to the best available account, re-authorizing expired accounts, and launching codex after switching.
$ install --global
skillsauthnpx skillsauth add lilong7676/codex-pool codex-poolInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 10:39 AM7.2s1 file scanned
SKILL.md
- name:
- codex-pool
- description:
- Manage multiple Codex CLI accounts with codex-pool, including checking 5h and 1week usage, switching to the best available account, re-authorizing expired accounts, and launching codex after switching.
- version:
- 0.1.4
- author:
- lilong7676
- fileRead:
- Read local Codex auth state, the installed codex-pool binary status, and local account store paths before acting.
- fileWrite:
- Install the codex-pool binary into the configured local bin directory and, after user confirmation, update ~/.codex/auth.json plus codex-pool's own state under ~/.codex-pool/.
- network:
- Download the pinned codex-pool release archive and checksum from this repository's GitHub Releases, refresh account usage against ChatGPT/OpenAI endpoints, and refresh login tokens when codex-pool needs to recover an expired session.
- shell:
- Run codex and codex-pool CLI commands needed for inspection, switching, installation, and re-authorization.
- - ${INSTALL_DIR:
- -$HOME/.local/bin}/codex-pool
Codex Pool
Use this skill when the user wants to inspect, switch, or repair Codex CLI accounts managed by codex-pool.
Workflow
- Check that the official
codexCLI is installed before doing anything else. - Check whether
codex-poolis already installed withcommand -v codex-pool, and if present compare its current version to the pinnedv0.1.4skill version. - If
codex-poolis missing or older than the pinned skill version, explain that the skill will download the pinnedv0.1.4release archive and SHA256 file from this repository's GitHub Releases, verify the checksum, and install or upgrade the binary at${INSTALL_DIR:-$HOME/.local/bin}/codex-pool. - Only after explicit user confirmation, install or upgrade it with
CODEX_POOL_INSTALL_APPROVED=1 ./scripts/ensure-codex-pool.sh. - Prefer non-mutating commands first:
codex-pool doctorcodex-pool list --refreshcodex-pool watchcodex-pool refresh
- Only run mutating commands after the user clearly asks for them or explicitly confirms:
codex-pool initcodex-pool addcodex-pool reauth <account-ref>codex-pool use <account-ref>orcodex-pool use --bestcodex-pool run <account-ref> ...orcodex-pool run --best ...
Safety Boundary
./scripts/ensure-codex-pool.shdownloads from this repository's GitHub Releases (github.comwith GitHub-owned release asset redirects) and installs or upgradescodex-poolin${INSTALL_DIR:-$HOME/.local/bin}.codex-pool list --refresh,codex-pool watch, andcodex-pool refreshmay call ChatGPT usage endpoints onchatgpt.com, or another host already configured in the local Codex config.- Token refresh paths may call the OAuth issuer in the existing auth token, typically
auth.openai.com. codex-pool use,codex-pool run,codex-pool init,codex-pool add, andcodex-pool reauthmay overwrite the live auth file at~/.codex/auth.json.codex-pool init,codex-pool add,codex-pool reauth, and other account-management commands may create or update~/.codex-pool/accounts.jsonand~/.codex-pool/config.toml.codex-pool add,codex-pool init, andcodex-pool reauthmay launch the browser viacodex login.codex-pool run ...starts another process after switching auth; only use it when the user explicitly asks to launchcodexor another program.codex-pool updatedownloads a GitHub Release archive plus checksum and overwrites the installed binary in place; only use it after explicit user confirmation.- Do not install or upgrade
codex-pool, switch accounts, start re-authorization, or launch a child process without explicit user confirmation.
Recommended Sequence
- If
codex-poolis missing or older thanv0.1.4, stop and ask for install or upgrade confirmation before running the installer. - Start with
codex-pool doctorto confirm prerequisites. - Use
codex-pool list --refreshto inspect account status and usage. - If the user wants the best account, prefer
codex-pool use --bestafter confirmation. - Only use
codex-pool run --bestwhen the user explicitly wants to launchcodexor another program after switching. - If an account is expired or requires login, use
codex-pool reauth <account-ref>after confirmation. - If the user explicitly wants to upgrade
codex-pooloutside the skill bootstrap flow, prefercodex-pool updateor rerunning the publishedinstall.sh.
References
- For command behavior and ranking rules, read
./references/commands.md.
Related Skills
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026
steipete/xurl
tools
VerifiedTrustedCommunity
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
356,423SKILL.mdUpdated Apr 13, 2026