CLI README Accuracy Issues

[rodmhgl]

Discrepancies Found

1. Documented flags/options that do not exist in the code

The README documents these CLI options that are not implemented. If these are suggested/aspirational, it should be called out in the text.

Documented Feature	README Line(s)	Exists in Code?
--token TOKEN	L199, L211, L351-358, L401	NO — not in argparse
--output FORMAT (json/text)	L220-227, L237, L402	NO — not in argparse
--verbose / --debug	L380-382, L403	NO — not in argparse
--force flag on delete	L184	NO — not in argparse
--quiet flag on health	L250	NO — not in argparse

2. Documented behaviors that do not exist in the code

Documented Behavior	Reality
Delete command prompts "Are you sure?" (L177)	No confirmation prompt — deletes immediately
Get team shows "Members: 8" and "Status: Active" (L164-165)	Code only shows name, id, created_at
Environment variable TEAMS_API_URL support (L210)	Not implemented — only --url flag works
Environment variable TEAMS_API_TOKEN (L211)	Not implemented

3. Exit codes documented but not implemented (L417-422)

The README documents exit codes 0-4 with specific meanings. The code only uses sys.exit(0) and sys.exit(1) — no distinction between error types (codes 2, 3, 4 don't exist).

4. Default API URL mismatch

• README L400: --url URL: API base URL (default: http://localhost:8080)
• Code L12: API_BASE_URL = "http://teams-api.127.0.0.1.sslip.io"

5. Minor inaccuracies

• README flips between teams_cli.py for the long name and teams-cli as global command name. Perhaps standardize on _ or -

Verification

After editing:

1. Every --flag mentioned in the README should exist in teams_cli.py's argparse setup OR should be explicitly called out as aspirational
2. Every command example output should match what the code actually prints