Skip to content

Commit 53488ef

Browse files
committed
Add Codex plugin manifest and setup skill
1 parent ab3ac21 commit 53488ef

File tree

2 files changed

+79
-0
lines changed

2 files changed

+79
-0
lines changed

.codex-plugin/plugin.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"name": "codex-multi-auth",
3+
"version": "1.2.1",
4+
"description": "Install and operate codex-multi-auth for the official @openai/codex CLI with multi-account OAuth rotation, switching, health checks, and recovery tools.",
5+
"skills": "./skills/"
6+
}

skills/codex-auth-setup/SKILL.md

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
name: codex-auth-setup
3+
description: Install or refresh codex-multi-auth for the official Codex CLI, run first login, and verify account health and routing.
4+
---
5+
6+
# codex-auth-setup
7+
8+
Use this skill when the user wants to install, reinstall, upgrade, or troubleshoot `codex-multi-auth` for the official `@openai/codex` CLI.
9+
10+
## Install
11+
12+
```bash
13+
npm i -g @openai/codex
14+
npm i -g codex-multi-auth
15+
```
16+
17+
If the old scoped prerelease package is still installed:
18+
19+
```bash
20+
npm uninstall -g @ndycode/codex-multi-auth
21+
npm i -g codex-multi-auth
22+
```
23+
24+
## First login
25+
26+
```bash
27+
codex auth login
28+
```
29+
30+
Default flow:
31+
32+
1. Open the account menu.
33+
2. Choose the browser-first OAuth path.
34+
3. Complete the official OAuth flow.
35+
4. Return to the terminal and confirm the account was saved.
36+
37+
## Verify health and routing
38+
39+
```bash
40+
codex auth status
41+
codex auth list
42+
codex auth check
43+
codex auth forecast --live
44+
```
45+
46+
Use these next when managing multiple accounts:
47+
48+
```bash
49+
codex auth switch 2
50+
codex auth verify-flagged
51+
codex auth doctor --fix
52+
```
53+
54+
## Alternate login paths
55+
56+
Use these when browser launch is blocked or the shell is headless:
57+
58+
```bash
59+
codex auth login --manual
60+
CODEX_AUTH_NO_BROWSER=1 codex auth login
61+
```
62+
63+
## Troubleshooting
64+
65+
- Run `where codex` if `codex auth` is not recognized.
66+
- Free port `1455` and retry if the OAuth callback server cannot bind.
67+
- Re-run `codex auth login` if the active account is stale or the wrong account was selected.
68+
- Use `codex auth doctor --fix` followed by `codex auth check` for a fast recovery loop.
69+
- See `docs/getting-started.md`, `docs/configuration.md`, `docs/troubleshooting.md`, and `docs/reference/commands.md` for the full command and config docs.
70+
71+
## Usage boundaries
72+
73+
This project is for personal development use. For production or commercial workloads, use the OpenAI Platform API.

0 commit comments

Comments
 (0)