SwiftRouter CLI

The Official Command Line Interface for SwiftRouter API Gateway, built with React Ink.

V3 Features (Codex Parity)

• Interactive Markdown Renderer: Syntactically highlights Assistant markdown responses within the terminal.
• Intelligent Bash Execution: Automatically detects bash snippet blocks and prompts: Execute suggested command? [Y/n].
• RAG Local Workspaces: Injects process.cwd() state and files directly into a system prompt context so the AI knows where you are.
• Persistent History Storage: Automatically saves conversation threads to ~/.swiftrouter-cli/history.json and recalls them using up/down keys in the input.
• Slash Commands & Menus: Type /models to pop open a sleek ink-select-input menu fetched directly from the SwiftRouter /v1/models API endpoint. Navigate with up/down arrows!
• System Commands: Type /clear to reset the terminal history buffer, or /exit//quit to cleanly exit the CLI.

Installation

npm install -g swiftroutercli

Configuration

Upon first launch, the CLI asks for configuration parameters. You can also configure via system ENV variables:

• SWIFTROUTER_API_KEY
• SWIFTROUTER_BASE_URL (Defaults to http://localhost:3000)

Usage

Simply run the CLI anywhere on your system:

swiftroutercli chat

• Type /models to select models interactively.
• Type /clear to reset the session.
• Type /exit to quit.

Additional Commands

• swiftroutercli config --set-api-key <KEY> --set-base-url <URL>: Manually configure CLI
• swiftroutercli models: List available models natively
• swiftroutercli status: Check authentication and connection status
• swiftroutercli logout: Clear local configuration securely

Built With

• ink
• marked-terminal
• ink-select-input
• eventsource-parser

License

ISC