From 433d8a48080b04db8485980eeaca9362a4ea5e3b Mon Sep 17 00:00:00 2001
From: Beon de Nood <beon@bigdune.net>
Date: Fri, 26 Dec 2025 22:45:29 -0500
Subject: [PATCH] docs: fix incorrect CLI command syntax

- Change 'capiscio version' to 'capiscio --version' (version is a flag, not command)
- Fix 'key gen --output' to 'key gen --out-priv/--out-pub' (correct flag names)
- Remove '(includes scores)' from JSON output description (clarification)
---
 README.md                            | 4 ++--
 docs/getting-started/installation.md | 2 +-
 docs/index.md                        | 4 ++--
 docs/reference/commands.md           | 6 +++---
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 390b8d1..7d16499 100644
--- a/README.md
+++ b/README.md
@@ -27,11 +27,11 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 # Validate an agent
 capiscio validate https://my-agent.example.com
 
-# Validate with JSON output (includes scores)
+# Validate with JSON output
 capiscio validate https://my-agent.example.com --json
 
 # Check version
-capiscio version
+capiscio --version
 ```
 
 ### Wrapper Utilities
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 1c3b3c9..09cbd1b 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -19,7 +19,7 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 capiscio validate ./agent-card.json
 
 # Check version
-capiscio version
+capiscio --version
 ```
 
 For full command reference, see the [CapiscIO Core Documentation](../../capiscio-core/index.md).
diff --git a/docs/index.md b/docs/index.md
index b0281c3..c7a0e41 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -39,11 +39,11 @@ pip install capiscio
 # Validate an agent card
 capiscio validate ./agent-card.json
 
-# Validate with JSON output (includes scores)
+# Validate with JSON output
 capiscio validate ./agent-card.json --json
 
 # Check core binary version
-capiscio version
+capiscio --version
 ```
 
 ## What This Package Does
diff --git a/docs/reference/commands.md b/docs/reference/commands.md
index 05b3341..a6bd412 100644
--- a/docs/reference/commands.md
+++ b/docs/reference/commands.md
@@ -39,8 +39,8 @@ capiscio validate ./agent-card.json --json
 capiscio validate https://agent.example.com --test-live
 
 # Check version of the core binary
-capiscio version
+capiscio --version
 
-# Generate a signing key
-capiscio key gen --output ./my-key.jwk
+# Generate a signing key pair
+capiscio key gen --out-priv ./private.jwk --out-pub ./public.jwk
 ```