Skip to content

docs(cli): scope Codex token injection (avoid shell-profile export) - #419

Open
luvs01 wants to merge 20 commits into
Devfrom
codex/fix-shell-profile-guidance-vulnerability
Open

docs(cli): scope Codex token injection (avoid shell-profile export)#419
luvs01 wants to merge 20 commits into
Devfrom
codex/fix-shell-profile-guidance-vulnerability

Conversation

@luvs01

@luvs01 luvs01 commented Sep 3, 2026

Copy link
Copy Markdown
Owner

Motivation

  • The docs previously suggested carrying the service-api-token into Codex via a shell-profile export, which would make the reusable data-plane bearer token available to every child process started from that shell and thus broaden the intended confidentiality boundary.

Description

  • Replace the shell-profile export advice in docs-site/src/content/docs/reference/cli/lifecycle.md with a recommendation to use a dedicated, command-scoped launcher that reads the owner-only service-api-token, exports OPENCODEX_API_AUTH_TOKEN, and immediately executes codex so the token is not persisted to a user session.
  • Add an explicit warning to never export the token from a shell profile and clarify that the service-api-token file holds a raw token (not NAME=value) and therefore is not suitable to point at via systemd EnvironmentFile=.

Testing

  • Built the docs with cd docs-site && bun install --frozen-lockfile && bun run build, which completed successfully.
  • Ran typecheck with node_modules/.bin/bun run typecheck and a privacy scan with bun run privacy:scan, both succeeded.
  • Executed the repository test suite with node_modules/.bin/bun run test; the documentation-specific checks passed but the full test run failed due to unrelated existing runtime/timeout failures in the current checkout (not caused by this docs change).

Codex Task

lidge-jun and others added 20 commits August 25, 2026 10:36
release: promote dev into main for v2.32.1
# Conflicts:
#	package.json
[WRONG BRANCH] merge dev into main for the v2.33.0 release
Promotes the dev integration line onto main. The resulting tree is byte-identical
to origin/dev, including package.json at 2.34.0.

The package.json conflict is resolved to dev's side, NOT to main's stale 2.33.0.
Earlier promotions (lidge-jun#2553, lidge-jun#2507) kept the target's version so the release bump
would land on its own "release: vX.Y.Z" commit. That is no longer legal: this very
delta adds tests/release-version-line.test.ts, which fails when the in-tree version
sits behind the highest release tag. With v2.34.0-preview.20260827 now published,
2.33.0 orders behind it, so a promotion carrying the stale line turns CI red on
every shard that runs the suite.

The consequence for the release step is that scripts/release.ts skips the bump
(release.ts:568, currentVersion === version), so v2.34.0 gets tagged on this merge
commit rather than on a separate release commit. The workflow creates the tag itself
after publishing and validates expected-sha against the checked-out commit, so the
tag still names exactly the audited tree.
[WRONG BRANCH] promote dev onto main for v2.34.0
[WRONG BRANCH] promote dev onto main for v2.35.0
[WRONG BRANCH] promote dev onto main for v2.36.0
[WRONG BRANCH] promote dev to main for the v2.37.0 release
[WRONG BRANCH] promote dev onto main for v2.38.0
[WRONG BRANCH] promote dev onto main for v2.39.0
…rkflow call (lidge-jun#3262)

Both v2.40.0 release dispatches (33615174183 preview, 33615177849 main) died
at startup_failure: a workflow_call cannot grant its callee more than the
calling job holds, and dev-version-bump.yml's job declares contents+pull-
requests write. lidge-jun#3129 wired the call but never dispatched a release, so this
is its first live run. The caller job now declares exactly the callee's two
permissions; no other job in release.yml gains anything.

Co-authored-by: jun <jun@lidge.dev>
(cherry picked from commit 7ce0ba5)
…400-relfix

release: carry the release.yml permissions fix onto main for v2.40.0
@coderabbitai

coderabbitai Bot commented Sep 3, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 21e325b8-11ed-4212-8963-08dcd3007b55


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 3, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-03T06:15:42.829045Z 7cc3950 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Sep 3, 2026
@github-actions github-actions Bot changed the title docs(cli): scope Codex token injection (avoid shell-profile export) [WRONG BRANCH] docs(cli): scope Codex token injection (avoid shell-profile export) Sep 3, 2026
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown

✅ READY

  • all PR quality gates passed.

Hygiene

Deterministic PR hygiene checks passed.

@github-actions
github-actions Bot marked this pull request as draft September 3, 2026 06:15
@luvs01 luvs01 changed the title [WRONG BRANCH] docs(cli): scope Codex token injection (avoid shell-profile export) docs(cli): scope Codex token injection (avoid shell-profile export) Sep 3, 2026
@luvs01
luvs01 changed the base branch from main to dev September 3, 2026 06:19
@github-actions
github-actions Bot marked this pull request as ready for review September 3, 2026 06:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

aardvark codex documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants