# shell-gpt

A command-line productivity tool powered by AI large language models

**Score:** 57% pass rate
**Principles:** 4/7 met

## Embed the badge

The [badge floor](https://anc.dev/badge) is 80%; this scorecard is at 57% (23 points below). Once the score clears the floor, the embed snippet will appear here.

| Status | Check | Principle | Evidence |
|--------|-------|-----------|----------|
| FAIL | Help flag produces useful output | [P3](https://anc.dev/p3) | --help exited with code 1 |
| FAIL | Version flag works | [P3](https://anc.dev/p3) | --version exited with code 1 |
| SKIP | Structured output support | [P2](https://anc.dev/p2) | no --output/--format flag detected |
| PASS | Rejects invalid arguments | [P4](https://anc.dev/p4) |  |
| WARN | Quiet mode available | [P7](https://anc.dev/p7) | no --quiet/-q flag detected in --help output |
| PASS | Handles SIGPIPE gracefully | [P6](https://anc.dev/p6) |  |
| PASS | Non-interactive by default | [P1](https://anc.dev/p1) |  |
| SKIP | Non-interactive gate flag advertised in --help | [P1](https://anc.dev/p1) | target satisfies P1 via alternative gate (help-on-bare or stdin-primary) |
| SKIP | Flags advertise env-var bindings in --help | [P1](https://anc.dev/p1) | target exposes no flags in --help |
| SKIP | Pager-using CLI ships --no-pager escape hatch | [P6](https://anc.dev/p6) | no pager signal (less/more/$PAGER/--pager) in --help |
| PASS | Respects NO_COLOR | [P6](https://anc.dev/p6) |  |

**Repo:** [TheR1D/shell_gpt](https://github.com/TheR1D/shell_gpt)
**Language:** Python
**Version scored:** 3.14
**Audit date:** 2026-05-01 10:09:19 UTC
**Duration:** 866ms
**Platform:** `linux/x86_64`
**Mode:** command
**Anc build:** 0.3.0
**Install:** `uv tool install shell-gpt`

## Reproduce locally

```bash
anc check --command sgpt --output json
```