Skip to content

docs: add Gemini CLI agents guide - #429

Open
michaelxu2288 wants to merge 1 commit into
scaleapi:mainfrom
michaelxu2288:docs/gemini-cli-agents
Open

docs: add Gemini CLI agents guide#429
michaelxu2288 wants to merge 1 commit into
scaleapi:mainfrom
michaelxu2288:docs/gemini-cli-agents

Conversation

@michaelxu2288

@michaelxu2288 michaelxu2288 commented Sep 10, 2026

Copy link
Copy Markdown

What

Companion to scaleapi/scale-agentex-python#516 ("feat(harness): add a Gemini CLI harness"). Adds development_guides/gemini_cli_agents.md (CLI invocation with the prompt on argv and stdin closed, the stream-json to canonical-event mapping table, usage normalisation, the multi-turn caveat since --resume is index-based, tool approval modes), adds it to the Framework Agents nav, and lists Gemini CLI in the framework table and the coding-CLI bullet of Choose Your Agent Type.

Test

mkdocs build --strict with docs/requirements.txt: the page renders and its links resolve; no warnings reference the changed files (the 15 pre-existing strict-mode warnings are unrelated).

https://claude.ai/code/session_01HCVKnA7LeJZ44nxZz1uzF3

Companion to the scale-agentex-python change that adds a Gemini CLI harness
(convert_gemini_cli_to_agentex_events, GeminiCliTurn, and sync / async /
temporal agentex init templates). Documents the CLI invocation, the
stream-json to canonical-event mapping, usage normalisation, and the
multi-turn and tool-approval caveats; adds the page to the Framework Agents
nav and lists Gemini CLI among the coding-CLI options.

Claude-Session: https://claude.ai/code/session_01HCVKnA7LeJZ44nxZz1uzF3
@michaelxu2288
michaelxu2288 requested a review from a team as a code owner September 10, 2026 17:15

The template spawns the CLI in streaming-JSON mode with the prompt on the command line and stdin closed:

```python

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 security Prompt Exposed in Arguments

Passing the potentially user-supplied prompt through -p puts its full contents in the subprocess argument list, where process listings or process telemetry may capture it. This is a non-blocking documentation concern: please warn readers not to include secrets and recommend suitable isolation or redaction for shared environments.

How this was verified: The documented command directly inserts prompt into the argument list passed to create_subprocess_exec.

Prompt To Fix With AI
This is a comment left during a code review.
Path: agentex/docs/docs/development_guides/gemini_cli_agents.md
Line: 16

Comment:
**Prompt Exposed in Arguments**

Passing the potentially user-supplied prompt through `-p` puts its full contents in the subprocess argument list, where process listings or process telemetry may capture it. This is a non-blocking documentation concern: please warn readers not to include secrets and recommend suitable isolation or redaction for shared environments.

**How this was verified:** The documented command directly inserts `prompt` into the argument list passed to `create_subprocess_exec`.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Fix in Cursor Fix in Claude Code Fix in Codex

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant