eightstatecli 0.4.2__tar.gz → 0.4.3__tar.gz

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eightstatecli
-Version: 0.4.2
+Version: 0.4.3
 Summary: Eightstate CLI — unified AI services from the command line
 Project-URL: Homepage, https://github.com/eight-state/eightstate
 Project-URL: Repository, https://github.com/eight-state/eightstate

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "eightstatecli"
-version = "0.4.2"
+version = "0.4.3"
 description = "Eightstate CLI — unified AI services from the command line"
 readme = "README.md"
 requires-python = ">=3.10"

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/__init__.py

@@ -17,7 +17,7 @@ AGENT INSTRUCTIONS:
   - Exit codes: 0=success, 1=error, 2=usage
 """
 
-__version__ = "0.4.1"
+__version__ = "0.4.3"
 
 import argparse
 import base64
@@ -718,7 +718,7 @@ config: ~/.escli/config.json (600 permissions, owner-only)
     subs = root.add_subparsers(dest="command", metavar="command")
 
     # ── auth ──────────────────────────────────────────────────────────
-    auth_p = subs.add_parser("auth", aliases=["a"], help="Authentication and profiles", formatter_class=F,
+    auth_p = subs.add_parser("auth", aliases=["a"], help="Manage API auth and profiles", formatter_class=F,
                              epilog=f"""subcommands:
   login    {DOT} authenticate with API key
   logout   {DOT} remove credentials
@@ -733,7 +733,7 @@ agent examples:
 """)
     auth_subs = auth_p.add_subparsers(dest="auth_command", metavar="subcommand")
 
-    login_p = auth_subs.add_parser("login", aliases=["l"], help="Authenticate with an API key", formatter_class=F,
+    login_p = auth_subs.add_parser("login", aliases=["l"], help="Authenticate via browser or API key", formatter_class=F,
                                    epilog=f"""examples:
   escli auth login                    {DOT} interactive prompt
   escli auth login --key sk-xxx       {DOT} non-interactive (agents/CI)
@@ -745,24 +745,24 @@ agent: escli --json auth login --key sk-xxx
 """)
     login_p.add_argument("--key", "-k", default=None, help="API key (omit for interactive prompt)")
     login_p.add_argument("--profile", "-p", default="default", help="Profile name (default: default)")
-    login_p.add_argument("--label", default=None, help="Human-readable label for this profile")
-    login_p.add_argument("--endpoint", default=None, help=f"API endpoint (default: {ENDPOINT})")
+    login_p.add_argument("--label", default=None, help="Profile label")
+    login_p.add_argument("--endpoint", default=None, help="API endpoint")
     login_p.set_defaults(func=cmd_auth_login)
 
     logout_p = auth_subs.add_parser("logout", help="Remove stored credentials")
     logout_p.add_argument("--profile", "-p", default=None, help="Profile to remove (default: active)")
-    logout_p.add_argument("--all", action="store_true", help="Remove ALL profiles")
+    logout_p.add_argument("--all", action="store_true", help="Remove all profiles")
     logout_p.set_defaults(func=cmd_auth_logout)
 
-    auth_subs.add_parser("status", aliases=["s", "whoami"], help="Show current auth status").set_defaults(func=cmd_auth_status)
-    auth_subs.add_parser("profiles", aliases=["ls", "list"], help="List all profiles").set_defaults(func=cmd_auth_profiles)
+    auth_subs.add_parser("status", aliases=["s", "whoami"], help="Show current profile and auth state").set_defaults(func=cmd_auth_status)
+    auth_subs.add_parser("profiles", aliases=["ls", "list"], help="List all stored profiles").set_defaults(func=cmd_auth_profiles)
 
-    switch_p = auth_subs.add_parser("switch", aliases=["use"], help="Switch active profile")
+    switch_p = auth_subs.add_parser("switch", aliases=["use"], help="Switch the active profile")
     switch_p.add_argument("profile_name", help="Profile to activate")
     switch_p.set_defaults(func=cmd_auth_switch)
 
     # ── image ─────────────────────────────────────────────────────────
-    image_p = subs.add_parser("image", aliases=["img", "i"], help="Image generation and editing", formatter_class=F,
+    image_p = subs.add_parser("image", aliases=["img", "i"], help="Generate or edit images from prompts", formatter_class=F,
                               epilog=f"""subcommands:
   generate (gen, g)  {DOT} generate image from text prompt
   edit (e)           {DOT} edit existing image with instruction
@@ -777,29 +777,29 @@ sizes: square(1024x1024) landscape(1536x1024) portrait(1024x1536)
     image_subs = image_p.add_subparsers(dest="image_command", metavar="subcommand")
 
     def add_image_flags(p, include_input=False):
-        p.add_argument("prompt", nargs="+", help="Text prompt describing desired image")
+        p.add_argument("prompt", nargs="+", help="Text prompt")
         p.add_argument("-s", "--size", default=os.environ.get("ESCLI_IMAGE_SIZE", DEFAULTS["size"]),
-                       help="Image size: square|sq|landscape|wide|ls|portrait|tall|port or WxH (default: square = 1024x1024)")
+                       help="Size: sq|wide|tall or WxH (default: 1024x1024)")
         p.add_argument("-q", "--quality", default=os.environ.get("ESCLI_IMAGE_QUALITY", DEFAULTS["quality"]),
-                       choices=VALID_QUALITIES, help="Quality: low (fast, ~15s) | medium (~25s) | high (best, ~40s) (default: high)")
+                       choices=VALID_QUALITIES, help="Quality: low|medium|high (default: high)")
         p.add_argument("-f", "--format", default=os.environ.get("ESCLI_IMAGE_FORMAT", DEFAULTS["format"]),
-                       choices=VALID_FORMATS, help="Output format: png | jpeg | jpg | webp (default: png)")
+                       choices=VALID_FORMATS, help="Format: png|jpeg|webp (default: png)")
         p.add_argument("-m", "--model", default=os.environ.get("ESCLI_IMAGE_MODEL", DEFAULTS["model"]),
-                       help="Model to use (default: gpt-image-2)")
+                       help="Model (default: gpt-image-2)")
         p.add_argument("-o", "--output", default=None,
-                       help="Output file path. If omitted, auto-generates: YYYYMMDD-HHMMSS-slugified-prompt.png")
+                       help="Output path (default: auto-named in --out-dir)")
         p.add_argument("-d", "--out-dir", default=os.environ.get("ESCLI_OUT_DIR", DEFAULTS["out_dir"]),
-                       help="Output directory when -o not set (default: current dir)")
-        p.add_argument("--open", action="store_true", help="Open image in default viewer after generating")
+                       help="Output dir (default: .)")
+        p.add_argument("--open", action="store_true", help="Open result after writing")
         p.add_argument("--compression", type=int, default=None, metavar="0-100",
-                       help="Output compression level for jpeg/webp (0=min, 100=max)")
+                       help="JPEG/WebP compression 0-100")
         p.add_argument("--moderation", default=None, choices=["auto", "low"],
-                       help="Content moderation: auto (default) | low (permissive)")
+                       help="Moderation: auto|low")
         if include_input:
             p.add_argument("-i", "--input", required=True,
-                           help="Path to input image file to edit (png, jpg, webp)")
+                           help="Input image (png/jpg/webp)")
             p.add_argument("--fidelity", default=None, choices=["low", "high"],
-                           help="How closely to preserve the input image: low (more creative) | high (more faithful)")
+                           help="Fidelity to input: low|high")
 
     gen_p = image_subs.add_parser("generate", aliases=["gen", "g"], help="Generate an image from a text prompt",
                                   formatter_class=F, epilog=f"""sizes (any of these work for -s):
@@ -834,7 +834,7 @@ agent examples:
 """)
     add_image_flags(gen_p)
     gen_p.add_argument("--background", default=None, choices=VALID_BACKGROUNDS,
-                       help="Background: auto (default) | transparent (removes background)")
+                       help="Background: auto|transparent")
     gen_p.set_defaults(func=cmd_image_generate)
 
     edit_p = image_subs.add_parser("edit", aliases=["e"], help="Edit an existing image with an instruction",
@@ -863,7 +863,7 @@ supported input formats: png, jpg, jpeg, webp
     edit_p.set_defaults(func=cmd_image_edit)
 
     # ── models ────────────────────────────────────────────────────────
-    subs.add_parser("models", aliases=["m"], help="List available models", formatter_class=F,
+    subs.add_parser("models", aliases=["m"], help="List models available on the endpoint", formatter_class=F,
                     epilog=f"""lists all models available on the API endpoint.
 
 agent example:
@@ -896,7 +896,7 @@ agent example:
     register_usage(subs)
 
     # ── version ───────────────────────────────────────────────────────
-    subs.add_parser("version", help="Show version info").set_defaults(func=cmd_version)
+    subs.add_parser("version", help="Print escli version").set_defaults(func=cmd_version)
 
     return root
 

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/commands/audio.py

@@ -394,7 +394,7 @@ def register(subparsers):
     F = argparse.RawDescriptionHelpFormatter
 
     audio_p = subparsers.add_parser(
-        "audio", aliases=["au"], help="Audio transcription (AssemblyAI)",
+        "audio", aliases=["au"], help="Transcribe audio files or URLs",
         formatter_class=F,
         epilog="""subcommands:
   transcribe <file-or-url>    Transcribe audio with speaker diarization
@@ -413,42 +413,42 @@ examples:
     audio_subs = audio_p.add_subparsers(dest="audio_command", metavar="subcommand")
 
     # transcribe
-    tr_p = audio_subs.add_parser("transcribe", aliases=["t"], help="Transcribe audio")
+    tr_p = audio_subs.add_parser("transcribe", aliases=["t"], help="Transcribe an audio file or URL")
     tr_p.add_argument("source", help="Audio file path or URL")
-    tr_p.add_argument("-o", "--output", default=None, help="Write output to file")
-    tr_p.add_argument("--format", choices=["text", "json", "srt", "vtt"], default="text", help="Output format")
+    tr_p.add_argument("-o", "--output", default=None, help="Output file")
+    tr_p.add_argument("--format", choices=["text", "json", "srt", "vtt"], default="text", help="Output format: text|json|srt|vtt")
     # Speaker diarization
-    tr_p.add_argument("--speakers", action="store_true", help="Enable speaker labels")
+    tr_p.add_argument("--speakers", action="store_true", help="Speaker diarization")
     tr_p.add_argument("--speakers-expected", type=int, default=None, metavar="N", help="Expected speaker count (1-20)")
-    tr_p.add_argument("--speaker-names", default=None, metavar="A,B,C", help="Identify speakers by name")
+    tr_p.add_argument("--speaker-names", default=None, metavar="A,B,C", help="Identify speakers by name (comma-separated)")
     # Audio intelligence
-    tr_p.add_argument("--sentiment", action="store_true", help="Enable sentiment analysis")
-    tr_p.add_argument("--chapters", action="store_true", help="Enable auto chapters")
-    tr_p.add_argument("--entities", action="store_true", help="Enable entity detection")
-    tr_p.add_argument("--summarize", action="store_true", help="Enable summarization")
-    tr_p.add_argument("--highlights", action="store_true", help="Enable auto highlights")
-    tr_p.add_argument("--topics", action="store_true", help="Enable topic detection (IAB)")
-    tr_p.add_argument("--content-safety", action="store_true", help="Enable content safety detection")
+    tr_p.add_argument("--sentiment", action="store_true", help="Sentiment analysis")
+    tr_p.add_argument("--chapters", action="store_true", help="Auto chapters")
+    tr_p.add_argument("--entities", action="store_true", help="Entity detection")
+    tr_p.add_argument("--summarize", action="store_true", help="Summarization")
+    tr_p.add_argument("--highlights", action="store_true", help="Auto highlights")
+    tr_p.add_argument("--topics", action="store_true", help="IAB topic detection")
+    tr_p.add_argument("--content-safety", action="store_true", help="Content safety detection")
     # Transcription options
     tr_p.add_argument("--language", default=None, metavar="CODE", help="Language code (default: auto-detect)")
     tr_p.add_argument("--dual-channel", action="store_true", help="Dual channel transcription")
     tr_p.add_argument("--multichannel", action="store_true", help="Multichannel transcription")
-    tr_p.add_argument("--word-boost", default=None, metavar="W1,W2", help="Boost accuracy for words")
+    tr_p.add_argument("--word-boost", default=None, metavar="W1,W2", help="Boost accuracy for words (comma-separated)")
     tr_p.add_argument("--disfluencies", action="store_true", help="Include filler words")
     tr_p.add_argument("--filter-profanity", action="store_true", help="Filter profanity")
     tr_p.add_argument("--redact-pii", action="store_true", help="Redact PII")
     tr_p.set_defaults(func=cmd_transcribe)
 
     # status
-    st_p = audio_subs.add_parser("status", aliases=["s"], help="Check transcript status")
+    st_p = audio_subs.add_parser("status", aliases=["s"], help="Check transcript job status")
     st_p.add_argument("transcript_id", help="Transcript ID")
     st_p.set_defaults(func=cmd_status)
 
     # get
-    get_p = audio_subs.add_parser("get", aliases=["g"], help="Fetch completed transcript")
+    get_p = audio_subs.add_parser("get", aliases=["g"], help="Fetch a completed transcript")
     get_p.add_argument("transcript_id", help="Transcript ID")
-    get_p.add_argument("--format", choices=["text", "json", "srt", "vtt"], default="text", help="Output format")
-    get_p.add_argument("-o", "--output", default=None, help="Write output to file")
+    get_p.add_argument("--format", choices=["text", "json", "srt", "vtt"], default="text", help="Output format: text|json|srt|vtt")
+    get_p.add_argument("-o", "--output", default=None, help="Output file")
     get_p.set_defaults(func=cmd_get)
 
     # list

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/commands/docs.py

@@ -333,7 +333,7 @@ def register(subparsers):
     F = argparse.RawDescriptionHelpFormatter
 
     docs_p = subparsers.add_parser(
-        "docs", aliases=["d"], help="Library documentation search (Context7)",
+        "docs", aliases=["d"], help="Fetch up-to-date library docs",
         formatter_class=F,
         epilog="""subcommands:
   search <library>                Search for libraries
@@ -350,30 +350,30 @@ examples:
     docs_subs = docs_p.add_subparsers(dest="docs_command", metavar="subcommand")
 
     # search
-    search_p = docs_subs.add_parser("search", aliases=["s"], help="Search for libraries")
-    search_p.add_argument("library_name", help="Library name to search for")
+    search_p = docs_subs.add_parser("search", aliases=["s"], help="Search for libraries by name")
+    search_p.add_argument("library_name", help="Library name")
     search_p.add_argument("query", nargs="?", default=None, help="Optional search query")
-    search_p.add_argument("--limit", type=int, default=10, help="Limit results (default: 10)")
+    search_p.add_argument("--limit", type=int, default=10, help="Max results (default: 10)")
     search_p.add_argument("--refresh", action="store_true", help="Bypass cache")
     search_p.set_defaults(func=cmd_search)
 
     # get (one-shot: resolve + fetch)
-    get_p = docs_subs.add_parser("get", aliases=["g"], help="Resolve + fetch docs")
+    get_p = docs_subs.add_parser("get", aliases=["g"], help="Resolve a library and fetch docs in one shot")
     get_p.add_argument("library_name", help="Library name")
     get_p.add_argument("query", help="Documentation query")
     get_p.add_argument("--tokens", type=int, default=None, help="Max tokens to return")
     get_p.add_argument("--page", type=int, default=None, help="Page number (1-10)")
-    get_p.add_argument("--topic", default=None, help="Focus on specific topic")
+    get_p.add_argument("--topic", default=None, help="Focus on a topic")
     get_p.add_argument("--refresh", action="store_true", help="Bypass cache")
     get_p.set_defaults(func=cmd_get)
 
     # fetch (by library ID)
-    fetch_p = docs_subs.add_parser("fetch", aliases=["f"], help="Fetch docs by library ID")
+    fetch_p = docs_subs.add_parser("fetch", aliases=["f"], help="Fetch docs by exact library ID")
     fetch_p.add_argument("library_id", help="Library ID (e.g. /facebook/react)")
     fetch_p.add_argument("query", help="Documentation query")
     fetch_p.add_argument("--tokens", type=int, default=None, help="Max tokens to return")
     fetch_p.add_argument("--page", type=int, default=None, help="Page number (1-10)")
-    fetch_p.add_argument("--topic", default=None, help="Focus on specific topic")
+    fetch_p.add_argument("--topic", default=None, help="Focus on a topic")
     fetch_p.add_argument("--refresh", action="store_true", help="Bypass cache")
     fetch_p.set_defaults(func=cmd_fetch)
 

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/commands/research.py

@@ -700,7 +700,7 @@ def register(subparsers):
     F = argparse.RawDescriptionHelpFormatter
 
     p = subparsers.add_parser(
-        "research", aliases=["r"], help="Web research tasks (Parallel Task API)",
+        "research", aliases=["r"], help="Run deep web research tasks",
         formatter_class=F,
         epilog="""modes:
   escli research "query" -o report.md          Run a research task (default)
@@ -737,31 +737,31 @@ output modes:
     mode_g.add_argument("--result", default=None, metavar="RUN_ID", help="Fetch completed task result")
 
     # Run options
-    p.add_argument("-o", "--output", default=None, help="Output file path (markdown or JSON)")
+    p.add_argument("-o", "--output", default=None, help="Output path (md or json)")
     p.add_argument("-p", "--processor", default="pro", choices=PROCESSORS, help="Processor tier (default: pro)")
 
     # Output schema
     schema_g = p.add_argument_group("output schema")
-    schema_g.add_argument("--text", action="store_true", help="Markdown report format")
+    schema_g.add_argument("--text", action="store_true", help="Markdown report output")
     schema_g.add_argument("--schema", default=None, metavar="FILE", help="JSON Schema file for structured output")
-    schema_g.add_argument("--output-schema", default=None, metavar="STR", help="Inline output schema description")
+    schema_g.add_argument("--output-schema", default=None, metavar="STR", help="Inline schema description")
 
     # Input
     input_g = p.add_argument_group("input")
-    input_g.add_argument("--input-json", default=None, metavar="JSON", help="JSON object as input (instead of text)")
-    input_g.add_argument("--input-file", default=None, metavar="FILE", help="JSON file as input")
+    input_g.add_argument("--input-json", default=None, metavar="JSON", help="JSON input (instead of text)")
+    input_g.add_argument("--input-file", default=None, metavar="FILE", help="JSON input file")
 
     # Source policy
     source_g = p.add_argument_group("source policy")
     source_g.add_argument("--include-domains", default=None, metavar="D1,D2", help="Only use these domains")
     source_g.add_argument("--exclude-domains", default=None, metavar="D1,D2", help="Exclude these domains")
-    source_g.add_argument("--after-date", default=None, metavar="YYYY-MM-DD", help="Only content after this date")
+    source_g.add_argument("--after-date", default=None, metavar="YYYY-MM-DD", help="Filter content after this date")
 
     # Advanced
     adv_g = p.add_argument_group("advanced")
-    adv_g.add_argument("--location", default=None, metavar="CC", help="ISO country code for geo-targeted results")
+    adv_g.add_argument("--location", default=None, metavar="CC", help="ISO country code for geo-targeting")
     adv_g.add_argument("--metadata", default=None, help="Metadata as JSON or key=val,key=val")
-    adv_g.add_argument("--follow-up", default=None, metavar="RUN_ID", help="Follow-up on a previous task run")
+    adv_g.add_argument("--follow-up", default=None, metavar="RUN_ID", help="Follow up on a previous run")
     adv_g.add_argument("--no-basis", action="store_true", help="Exclude citations and reasoning")
 
     p.set_defaults(func=_dispatch)

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/commands/search.py

@@ -268,7 +268,7 @@ def register(subparsers):
 
     # search
     search_p = subparsers.add_parser(
-        "search", aliases=["s"], help="Web search (Parallel.ai)",
+        "search", aliases=["s"], help="Search the web, return ranked excerpts",
         formatter_class=F,
         epilog="""examples:
   escli search "latest cloudflare workers features"
@@ -278,14 +278,14 @@ def register(subparsers):
 Uses the free Parallel Search MCP. No API key needed.
 Add a Parallel API key for higher rate limits.
 """)
-    search_p.add_argument("objective", nargs="+", help="What you're searching for")
+    search_p.add_argument("objective", nargs="+", help="Search objective")
     search_p.add_argument("--queries", nargs="+", default=None, metavar="Q",
-                          help="Specific search queries (default: uses objective)")
+                          help="Override queries (default: objective)")
     search_p.set_defaults(func=cmd_search)
 
     # fetch
     fetch_p = subparsers.add_parser(
-        "fetch", aliases=["f"], help="Extract URL content (Parallel.ai)",
+        "fetch", aliases=["f"], help="Extract clean content from URLs",
         formatter_class=F,
         epilog="""examples:
   escli fetch https://docs.parallel.ai/search/search-quickstart
@@ -295,9 +295,9 @@ Add a Parallel API key for higher rate limits.
 
 Uses the free Parallel Extract MCP. No API key needed.
 """)
-    fetch_p.add_argument("urls", nargs="+", help="URLs to extract content from")
-    fetch_p.add_argument("--objective", default=None, help="Focus extraction on this topic")
-    fetch_p.add_argument("--full", action="store_true", help="Return full page content instead of excerpts")
+    fetch_p.add_argument("urls", nargs="+", help="URLs to extract")
+    fetch_p.add_argument("--objective", default=None, help="Focus on this topic")
+    fetch_p.add_argument("--full", action="store_true", help="Return full content (not excerpts)")
     fetch_p.set_defaults(func=cmd_fetch)
 
     return search_p

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/commands/social.py

@@ -215,7 +215,7 @@ def register(subparsers):
     F = argparse.RawDescriptionHelpFormatter
 
     p = subparsers.add_parser(
-        "social", help="Social media search (Tavily)",
+        "social", help="Search posts across social platforms",
         formatter_class=F,
         epilog="""platforms:
   reddit, x, tiktok, linkedin, instagram, facebook, youtube, combined (default)
@@ -235,11 +235,11 @@ time ranges:
   year    Last 12 months
 """)
 
-    p.add_argument("query", nargs="+", help="What to search for on social media")
+    p.add_argument("query", nargs="+", help="Search query")
     p.add_argument("--platform", "-p", default=None, metavar="P",
-                   help=f"Platform(s) to search, comma-separated ({', '.join(VALID_PLATFORMS)})")
+                   help=f"Platform(s), comma-separated ({', '.join(VALID_PLATFORMS)})")
     p.add_argument("--time", "-t", default=None, choices=VALID_TIME_RANGES, metavar="T",
-                   help="Time range: day, week, month, year")
+                   help="Time range: day|week|month|year")
     p.add_argument("--max-results", "-n", type=int, default=10, metavar="N",
                    help="Max results (1-20, default: 10)")
     p.add_argument("--depth", default="advanced", choices=VALID_DEPTHS,
@@ -247,11 +247,11 @@ time ranges:
     p.add_argument("--answer", "-a", action="store_true",
                    help="Include AI-synthesized answer")
     p.add_argument("--raw", action="store_true",
-                   help="Include full post content (raw markdown)")
+                   help="Include full post content")
     p.add_argument("--images", action="store_true",
-                   help="Include images from results")
+                   help="Include images")
     p.add_argument("--country", default=None, metavar="CC",
-                   help="Country for geo-targeted results (e.g. 'united states')")
+                   help="Country for geo-targeting (e.g. 'united states')")
     p.set_defaults(func=cmd_social)
 
     return p

{eightstatecli-0.4.2 → eightstatecli-0.4.3}/src/escli/commands/usage.py

@@ -390,7 +390,7 @@ def register(subparsers):
     F = argparse.RawDescriptionHelpFormatter
 
     p = subparsers.add_parser(
-        "usage", aliases=["u"], help="API usage and spend analytics",
+        "usage", aliases=["u"], help="Show API usage and spend",
         formatter_class=F,
         epilog=f"""examples:
   escli usage                          {DOT} summary, last 30 days
@@ -418,11 +418,11 @@ auth: requires `escli auth login` (uses CLI token, not API key).
     p.add_argument("--days", type=int, default=30, metavar="N",
                    help="Window size in days (default: 30)")
     p.add_argument("--service", default=None, metavar="NAME",
-                   help="Filter to a single service (e.g. parallel, openai, assemblyai)")
+                   help="Filter to one service (parallel|openai|assemblyai|...)")
     p.add_argument("--daily", action="store_true",
-                   help="Show day-by-day breakdown")
+                   help="Day-by-day breakdown")
     p.add_argument("--pricing", action="store_true",
-                   help="Show current pricing rules (ignores --days/--service)")
+                   help="Show current pricing rules")
     p.set_defaults(func=cmd_usage)
 
     return p