Skip to content

Claude/cli agent improvements xe8 fp#192

Closed
hifi-phil wants to merge 2 commits intoprjseal:feature/ai-agent-improvementsfrom
hifi-phil:claude/cli-agent-improvements-Xe8Fp
Closed

Claude/cli agent improvements xe8 fp#192
hifi-phil wants to merge 2 commits intoprjseal:feature/ai-agent-improvementsfrom
hifi-phil:claude/cli-agent-improvements-Xe8Fp

Conversation

@hifi-phil
Copy link

No description provided.

Analyse the PSW CLI tool for AI agent usability and document a
prioritised list of 16 improvements across 4 priority tiers. Key
recommendations include structured output modes (--output json/plain),
non-interactive flag, machine-readable help, valid value discovery
commands, distinct exit codes, and stderr/stdout separation.

https://claude.ai/code/session_01GKrYtcRN1vAEWzdPQakFqV
Add machine-readable output modes and automation flags to make the CLI
tool usable by AI agents without parsing decorated Spectre.Console text.

New features:
- --output json|plain flag for structured/plain output
- --script-only flag for raw script output without decoration
- --no-interaction flag to suppress all interactive prompts
- --dry-run flag to validate inputs without generating scripts
- --help-json flag for structured JSON help discovery
- psw list-options subcommand with database-types, starter-kits, defaults
- --template-version flag as explicit alternative to pipe syntax
- Distinct exit codes (0=success, 2=validation, 3=network, 4=execution, 5=fs)
- JSON error responses when using --output json

Breaking change:
- Unified -t and --template-package flags: bare values now treated as
  package names (not versions). Use --template-version or pipe syntax
  (Package|Version) for version specification.

Updated existing tests and added new tests for all new flags.

https://claude.ai/code/session_01GKrYtcRN1vAEWzdPQakFqV
@prjseal prjseal changed the base branch from main to feature/ai-agent-improvements February 11, 2026 21:11
@hifi-phil hifi-phil closed this Feb 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants