nils-cli

# nils-cli

[![CI](https://github.com/sympoies/nils-cli/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/sympoies/nils-cli/actions/workflows/ci.yml)
[![Coverage](https://raw.githubusercontent.com/sympoies/nils-cli/coverage-badge/badges/coverage.svg)](https://github.com/sympoies/nils-cli/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/sympoies/nils-cli?sort=semver)](https://github.com/sympoies/nils-cli/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

A Rust workspace of focused CLI binaries for API testing, Git operations, agent workflow evidence, provider automation, planning, and
desktop/media utilities. Shared crates keep JSON contracts, terminal UX, and cross-CLI behavior consistent.

## CLI surface map

Start here when choosing a binary. The source of truth for the current installable binary list is:

```bash
bash scripts/workspace-bins.sh
```

Completion obligations for those binaries are tracked in
[docs/specs/completion-coverage-matrix-v1.md](docs/specs/completion-coverage-matrix-v1.md).

| Area | Binaries | Use when |
| ---- | -------- | -------- |
| API testing | `api-rest`, `api-gql`, `api-grpc`, `api-websocket`, `api-test` | Run protocol-specific API checks or orchestrate a mixed API test suite. |
| Git tooling | `git-scope`, `git-cli`, `git-summary`, `git-lock` | Inspect changes, run Git helper flows, summarize commits, or manage repo-local commit locks. |
| Forge automation | `forge-cli` | Drive PR/MR + Issue lifecycle and repository label catalog maintenance on GitHub (via `gh`) or GitLab (via `glab`) through a single provider-neutral surface; covers create / view / edit / comment / ready / merge / close, label list / audit / ensure, CI wait-checks, and the `pr deliver` macro. |
| Agent policy and evidence | `agent-runtime`, `agent-docs`, `agent-memory`, `agent-out`, `agent-scope-lock`, `agent-run`, `test-first-evidence`, `web-evidence`, `browser-session`, `canary-check`, `docs-impact`, `heuristic-inbox`, `model-cross-check`, `repo-retro`, `review-evidence`, `review-specialists`, `skill-usage` | Render/install/audit runtime-kit surfaces, resolve agent policy docs, manage local agent memory stores, run project commands through explicit env handling, allocate artifact paths, enforce edit scope, inspect repo retrospectives, merge specialist review evidence, or persist deterministic workflow evidence. |
| Planning and delivery | `plan-tooling`, `plan-issue`, `plan-issue-local`, `semantic-commit` | Validate/split implementation plans, orchestrate issue delivery, rehearse local plan flows, or run validated commit workflows. |
| Provider lanes | `codex-cli`, `gemini-cli` | Run provider-specific diagnostics, auth checks, and workflow adapters. |
| Markdown rendering | `md-render` | Render `.md.tera` templates from JSON view data through the shared `nils-markdown` engine. |
| Desktop, media, and local utilities | `macos-agent`, `screen-record`, `image-processing`, `fzf-cli`, `memo-cli` | Automate local desktop tasks, capture media, convert images, use interactive shell helpers, or record/search local memos. |
| Development-only/internal | `cli-template` | Validate packaging and new-crate patterns; excluded from user-facing completion obligations. |

## Workspace layout

Each crate is either a standalone CLI binary, a multi-binary crate, or a shared library used across the workspace.

### Shared foundations

- [crates/nils-common](crates/nils-common): Shared cross-CLI utilities (including markdown payload validation and markdown-table
  canonicalization helpers).
- [crates/nils-markdown](crates/nils-markdown): Tera-backed Markdown template engine, shared helpers, golden-test harness, and
  opt-in `md-render` binary for rendering `.md.tera` templates from JSON view data.
- [crates/nils-term](crates/nils-term): Terminal UX helpers (TTY detection + progress rendering on stderr).
- [crates/nils-test-support](crates/nils-test-support): Test-only helpers for deterministic workspace integration tests.
- [crates/cli-template](crates/cli-template): Minimal example CLI for validating packaging and new-crate patterns.

### API testing stack

- [crates/api-testing-core](crates/api-testing-core): Shared library for the API testing CLIs (config/auth, history, reporting).
- [crates/api-rest](crates/api-rest): REST request runner from JSON request specs, with history + Markdown reports.
- [crates/api-gql](crates/api-gql): GraphQL operation runner for `.graphql` files (variables, history, reports, schema).
- [crates/api-grpc](crates/api-grpc): gRPC request runner from JSON specs, with history + Markdown reports.
- [crates/api-websocket](crates/api-websocket): Deterministic WebSocket request runner with history + Markdown reports.
- [crates/api-test](crates/api-test): Suite runner that orchestrates REST/GraphQL/gRPC/WebSocket cases and outputs JSON (and optional
  JUnit).

### Git tooling

- [crates/git-scope](crates/git-scope): Gi

... (truncated)