Repository navigation
Add chat REPL, doctor diagnostic, and expanded editor support - #2
Merged
Merged
Conversation
… templates - `install.sh` downloads the right prebuilt binary for the platform from the GitHub Release and drops it in ~/.local/bin. Lets users skip the Rust toolchain entirely. - `Dockerfile` produces a minimal Debian image; release workflow now pushes multi-arch images to ghcr.io. - `packaging/homebrew/scix-client.rb` is the formula template for a `yipihey/homebrew-scix` tap. Release workflow bumps it automatically if HOMEBREW_TAP_TOKEN is set. - `packaging/conda-forge/meta.yaml` is the seed recipe for submission to conda-forge/staged-recipes. - `packaging/README.md` documents the one-time setup for each channel. https://claude.ai/code/session_01KzghpfcHbnhrBTftUNeo3o
…x doctor - `scix setup` now detects three more MCP hosts: - Gemini CLI (Google) at ~/.gemini/settings.json - Codex CLI (OpenAI) at ~/.codex/config.toml — TOML, written via new helper - Windsurf (Codeium) at ~/.codeium/windsurf/mcp_config.json - Interactive token prompt offers to open the SciX token page in the user's default browser via the `webbrowser` crate. - New subcommand `scix doctor` prints a diagnostic checklist: binary location, PATH membership, token env, live API probe, and detected MCP hosts. Exits non-zero on any failed check. Cargo additions (cli feature only): toml, webbrowser. https://claude.ai/code/session_01KzghpfcHbnhrBTftUNeo3o
`scix chat` runs an interactive tool-use loop against Anthropic, OpenAI (also Ollama via OpenAI-compatible /v1), or Gemini. Provider is auto-detected from the environment (ANTHROPIC_API_KEY → OPENAI_API_KEY → GEMINI_API_KEY → OLLAMA_HOST) or selected with --provider. The tool set is the same one exposed by `scix serve` — `mcp::tool_definitions` and the per-tool dispatch table are now exposed as public helpers (`tool_definitions_value`, `dispatch_tool_call`) so the chat module reuses them verbatim. No tool implementations were duplicated. Tool schemas are translated to each provider's shape (Anthropic `input_schema`, OpenAI `function.parameters`, Gemini `functionDeclarations`) and the message history is converted from a single canonical Anthropic-style representation. Tool-call results are fed back as the next user turn, looping until the model produces a final answer or --max-turns is reached. This unlocks every model with an API key, with no MCP host required. https://claude.ai/code/session_01KzghpfcHbnhrBTftUNeo3o
- README gains a top-level Install section showing curl one-liner, pip, cargo, binstall, and Docker side-by-side, plus a `scix doctor` mention. - README adds a Chat REPL quick-start showing all four providers. - README mentions the new editors detected by `scix setup` (Gemini CLI, Codex CLI, Windsurf). - New docs/chat.md with provider matrix and troubleshooting. - docs/mcp-server.md updated with the new install paths and editor list. https://claude.ai/code/session_01KzghpfcHbnhrBTftUNeo3o
The curl installer + PyPI + crates.io paths cover almost all users without the maintenance overhead of an external tap repo, a conda-forge feedstock, or a Docker image. Removes: - Dockerfile + .dockerignore - packaging/ (Homebrew formula template, conda-forge recipe, READMEs) - `docker` and `homebrew` jobs from .github/workflows/release.yml - `packages: write` permission added for the GHCR push - Docker / Homebrew / conda mentions from README and docs/mcp-server.md https://claude.ai/code/session_01KzghpfcHbnhrBTftUNeo3o
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds three major features to scix-client:
Chat REPL (
scix chat) — a built-in interactive tool-use loop that drives any tool-use-capable LLM (Anthropic, OpenAI, Gemini, Ollama) against the SciX tool set without requiring an MCP host.Doctor diagnostic (
scix doctor) — a health-check command that validates installation, API token, connectivity, and editor detection.Expanded editor support — adds Gemini CLI, Codex CLI, and Windsurf to the MCP setup flow, along with improved UX (browser-opening for token acquisition, TOML config support).
Key Changes
New module:
src/chat.rs(626 lines)--providerdispatch_tool_call()New module:
src/doctor.rs(161 lines)Enhanced
src/setup.rsEditorTargetvariants:GeminiCli,CodexCli,Windsurfupdate_toml_codex_config)webbrowsercrate)detect_editors_public()for use by doctorRefactored
src/mcp.rsdispatch_tool_call()functionUpdated
src/bin/scix.rsDoctorandChatsubcommands with appropriate flagsNew installer script:
install.sh~/.local/bin(configurable viaSCIX_INSTALL_DIR)New documentation:
docs/chat.mdUpdated
README.mdscix doctorfor setup verificationUpdated
Cargo.tomltomlandwebbrowserto cli feature dependenciesImplementation Details
Message canonicalization: Chat uses an Anthropic-shaped message format internally, with provider-specific converters on the way out. This simplifies the tool-call loop logic.
Tool dispatch reuse: The
dispatch_tool_call()function is now the single source of truth for tool execution, used by both MCP and chat modes.Provider auto-detection: Checks environment variables in priority order (Anthropic → OpenAI → Gemini → Ollama) to select a provider without user input.
Error handling: Chat REPL gracefully handles API errors and tool execution failures, printing
https://claude.ai/code/session_01KzghpfcHbnhrBTftUNeo3o