v0.1.0

gemini-agent v0.1.0 Release Notes

v0.1.0 is the first open-source source release of gemini-agent.

The npm package remains marked "private": true, so this release is intended
for checked-out repository usage, local development, and local npm link
workflows rather than npm registry installation.

Highlights

• Local-first Gemini coprocessor for Codex and other agentic coding workflows.
• Focused CLI help for the common workflows users should try first.
• Reusable context packs for large repository, note, log, and diff context.
• Review gates for plans, patches, diffs, research briefs, screenshots, and UI
  artifacts.
• visual gate for screenshot smoke checks plus optional Gemini artifact review
  with pass, caution, or block-style output.
• design draft for design briefs, candidate generation, prototype drafts, and
  Codex handoff artifacts under .gemini-agent/design/<run-id>/.
• MCP server entrypoint with review tools and latest-artifact resources.
• Opt-in telemetry summaries, economics, priorities, raw governance, scheduler,
  and local receiver workflows.
• Open-source project hygiene: MIT license, contribution guide, security policy,
  GitHub Actions CI, bounded package files, and public README quick start.

Try First

npm install
./bin/gemini-agent auth status
./bin/gemini-agent ask "Reply with exactly: gemini-agent-ok"
./bin/gemini-agent diff-review --smart-diff

Use ./bin/gemini-agent --help for the short workflow surface and
./bin/gemini-agent --help-all for every operator command.

Safety Model

• gemini-agent does not edit source files, run deployment actions, or make
  final release decisions. Codex or the operator remains responsible for those
  steps.
• Credentials are read from environment variables or macOS Keychain. Status
  commands do not print secret values.
• Generated local artifacts live under .gemini-agent/, which is ignored by
  git.
• Raw telemetry is off by default and requires explicit
  --confirm-raw-content acknowledgement before prompts or responses are
  stored or sent to a configured receiver.
• Ordinary telemetry summaries and visual gate outputs avoid printing raw
  prompts, raw responses, local paths, event ids, batch ids, media file names,
  or image bytes.
• Live Gemini tests require explicit GEMINI_AGENT_RUN_LIVE_TESTS=1 opt-in.

Verification

The release branch was validated with:

npm test
npm audit --omit=dev
npm pack --dry-run
git diff --check
./bin/gemini-agent diff-review --smart-diff

Normal npm test uses Node's built-in test runner and keeps live Gemini smoke
tests skipped unless explicitly opted in.

Known Limits

• The package is not published to npm.
• PDF artifact review remains unsupported by the current inline image runtime.
• Image/design generation routes require explicit image model environment
  variables.
• Raw telemetry masking is best-effort and is not a complete PII or secret
  removal guarantee.