@psnext/slingcli 2.5.20260728-1 → 2.5.20260731-1

package/bin/sling.js

@@ -415,12 +415,175 @@ function updateSettings() {
   });
   writeFileSync(configPath, JSON.stringify(config, null, 2));
 }
+const helptext= `
+sling - An Terminal based coding agent part the Slingshot platform.
+
+Usage:
+  sling [options] [@files...] [messages...]
+
+Commands:
+  sling install <source> [-l]     Install extension source and add to settings
+  sling remove <source> [-l]      Remove extension source from settings
+  sling uninstall <source> [-l]   Alias for remove
+  sling update [source|self]      Update sling, extensions, or model catalogs
+  sling list                      List installed extensions from settings
+  sling config [-l]               Open TUI to enable/disable package resources (Tab switches scope)
+  sling <command> --help          Show help for install/remove/uninstall/update/list/config
+
+Options:
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --system-prompt <text>         System prompt (default: coding assistant prompt)
+  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)
+  --mode <mode>                  Output mode: text (default), json, or rpc
+  --print, -p                    Non-interactive mode: process prompt and exit
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path|id>            Use specific session file or partial UUID
+  --session-id <id>              Use exact project session ID, creating it if missing
+  --fork <path|id>               Fork specific session file or partial UUID into a new session
+  --session-dir <dir>            Directory for session storage and lookup
+  --no-session                   Don't save session (ephemeral)
+  --name, -n <name>              Set session display name
+  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
+                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
+  --no-tools, -nt                Disable all tools by default (built-in and extension)
+  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled
+  --tools, -t <tools>            Comma-separated allowlist of tool names to enable
+                                 Applies to built-in, extension, and custom tools
+  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable
+                                 Applies to built-in, extension, and custom tools
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh
+  --extension, -e <path>         Load an extension file (can be used multiple times)
+  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)
+  --skill <path>                 Load a skill file or directory (can be used multiple times)
+  --no-skills, -ns               Disable skills discovery and loading
+  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
+  --no-prompt-templates, -np     Disable prompt template discovery and loading
+  --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --no-themes                    Disable theme discovery and loading
+  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models (with optional fuzzy search)
+  --offline                      Disable startup network operations
+  --verbose                      Force verbose startup (overrides quietStartup setting)
+  --approve, -a                  Trust project-local files for this run
+  --no-approve, -na              Ignore project-local files for this run
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Extensions can register additional flags (e.g., --plan from plan-mode extension).
+Extension CLI Flags:
+  --profile <value>           Set a profile to use for this session (profiles stored in .sling/profiles/*).
+                              Usage: --profile=work or --profile=personal
+  --mcp-config <value>        Path to MCP config file
+
+
+Examples:
+  # Interactive mode
+  sling
+
+  # Interactive mode with initial prompt
+  sling "List all .ts files in src/"
+
+  # Include files in initial message
+  sling @prompt.md @image.png "What color is the sky?"
+
+  # Non-interactive mode (process and exit)
+  sling -p "List all .ts files in src/"
+
+  # Multiple messages (interactive)
+  sling "Read package.json" "What dependencies do we have?"
+
+  # Continue previous session
+  sling --continue "What did we discuss?"
+
+  # Start a named session
+  sling --name "Refactor auth module"
+
+  # Use model with provider prefix (no --provider needed)
+  sling --model gpt-4o "Help me refactor this code"
+
+  # Use model with thinking level shorthand
+  sling --model sonnet:high "Solve this complex problem"
+
+  # Limit model cycling to specific models
+  sling --models claude-sonnet,claude-haiku,gpt-4o
+
+  # Limit to a specific provider with glob pattern
+  sling --models "vertex/*"
+
+  # Cycle models with fixed thinking levels
+  sling --models sonnet:high,haiku:low
+
+  # Start with a specific thinking level
+  sling --thinking high "Solve this complex problem"
+
+  # Read-only mode (no file modifications possible)
+  sling --tools read,grep,find,ls -p "Review the code in src/"
+
+  # Disable one tool while keeping the rest available
+  sling --exclude-tools bash
+
+  # Export a session file to HTML
+  sling --export ~/.sling/agent/sessions/--path--/session.jsonl
+  sling --export session.jsonl output.html
+
+
+Built-in Tool Names:
+  read   - Read file contents
+  bash   - Execute bash commands
+  edit   - Edit files with find/replace
+  write  - Write files (creates/overwrites)
+  grep   - Search file contents (read-only, off by default)
+  find   - Find files by glob pattern (read-only, off by default)
+  ls     - List directory contents (read-only, off by default)
+
+
+Default Packages :
+  npm:pi-intercom              Session-to-session coordination across multiple sling instances
+  npm:@psnext/s-subagents      Subagent tools: scout (codebase explorer), researcher (web), worker (code changes)
+  npm:pi-ask-user              ask_user tool for interactive clarification with structured options
+  npm:pi-hermes-memory         Persistent memory, session search, and procedural skills (SQLite-backed)
+  npm:pi-smart-fetch           web_fetch with browser-grade TLS impersonation and article extraction
+  npm:pi-mcp-adapter           MCP (Model Context Protocol) server integration and tool bridging
+  npm:pi-goal-x                Goal mode: persistent objectives, /goal-set drafting, Sisyphus step-by-step mode
+
+
+Default Skills:
+  ce-brainstorm          Explore vague ideas into scoped requirements before planning
+  ce-code-review         Structured review for bugs, regressions, and standards
+  ce-commit              Create a clear, value-communicating git commit
+  ce-commit-push-pr      Commit, push, and open a PR
+  ce-compound            Document solved problems in docs/solutions/ or CONCEPTS.md
+  ce-compound-refresh    Audit stale or drifted docs/solutions learnings
+  ce-debug               Diagnosis loop for bugs, errors, and failing tests
+  ce-doc-review          Review requirements, plans, or specs with role-specific lenses
+  ce-explain             Turn code, diffs, or concepts into dense visual explainers
+  ce-ideate              Generate and evaluate grounded ideas before choosing one
+  ce-optimize            Metric-driven optimization loops (relevance, performance, scoring)
+  ce-plan                Create structured plans for multi-step work
+  ce-pov                 Project-grounded verdict on external tech/library/platform decisions
+  ce-proof               Publish, read, or edit markdown in Proof (sharing specs/plans)
+  ce-resolve-pr-feedback Resolve PR review comments and feedback threads
+  ce-riffrec-feedback-analysis  Analyze Riffrec feedback bundles (video/audio/session captures)
+  ce-setup               Set up a new project or development environment
+  ce-simplify-code       Refactor recently changed code for clarity and efficiency
+  ce-strategy            Create or update STRATEGY.md
+  ce-test-browser        Run browser tests for pages affected by current branch or PR
+  ce-test-xcode          Run Xcode tests
+  ce-work                Execute a plan or concrete work prompt end-to-end
+  ce-worktree            Set up isolated git worktrees for parallel work
+`;
 async function run() {
   const rawArgs = process.argv.slice(2);
   if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
     console.log(SLING_VERSION);
     process.exit(0);
   }
+  if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
+    console.log(helptext);
+    process.exit(0);
+  }
   setGlobalDispatcher(new EnvHttpProxyAgent({ bodyTimeout: 0, headersTimeout: 0 }));
   await productionOnly(checkForUpdate, rawArgs);
   syncBundledSkills();