# gemini-cli
## Overview
`gemini-cli` is the Gemini-specific CLI shell in the `nils-cli` workspace.
It currently provides the publish-ready parser topology and shell completion export surface.
Runtime ownership is implemented through `gemini-cli` adapters and shared
`nils-common::provider_runtime` helpers.
## Usage
```text
Usage:
gemini-cli <group> [command]
Groups:
agent
auth
diag
config
starship
## Scope boundary
- Runtime ownership is split between `gemini-cli` adapters and shared
`nils-common::provider_runtime` helpers.
- This crate owns Gemini command parsing shape and completion export.
- Legacy top-level groups `provider|debug|workflow|automation` are retained only as deterministic usage errors (`64`).
## Exit codes
- `0`: success and help output.
- `64`: usage or argument errors.
- `1`: unexpected internal failure while printing help.
## Docs
- [Docs index](docs/README.md)
- [Cross-lane parity contract](../../docs/specs/codex-gemini-cli-parity-contract-v1.md)