================================================================================
  SindByte MCP Server -- CLI Setup Guide Index
  All Supported AI Coding Assistants
================================================================================
Date: 2026-04-17
For: SindByte Server v1.9.09

--------------------------------------------------------------------------------
 1. WHAT IS THIS?
--------------------------------------------------------------------------------
This folder contains setup guides for every common CLI-based AI coding
assistant that can connect to SindByte's OpenAI-compatible endpoint.

SindByte runs a local API at http://127.0.0.1:8091/v1 that acts as a
gateway to your private LM Studio models and SindByte's IQ Tools pipeline.

--------------------------------------------------------------------------------
 2. AVAILABLE GUIDES
--------------------------------------------------------------------------------
  | File                                           | Tool              | Audience           |
  |------------------------------------------------|-------------------|--------------------|
  | SindByte_OpenCode_QuickStart.txt               | OpenCode CLI      | First-time users   |
  | SindByte_OpenCode_UserGuide.txt                | OpenCode CLI      | End users          |
  | SindByte_OpenCode_TechnicalReference.txt       | OpenCode CLI      | Developers         |
  | SindByte_Codex_CLI_Setup.txt                   | OpenAI Codex CLI  | Codex users        |
  | SindByte_Claude_Code_Setup.txt                 | Claude Code       | Claude users       |
  | SindByte_Kimi_Code_Setup.txt                   | Kimi Code CLI     | Kimi users         |
  | SindByte_Qwen_Code_Setup.txt                   | Qwen Code CLI     | Qwen users         |
  | SindByte_Gemini_CLI_Setup.txt                  | Gemini CLI        | Gemini users       |
  | SindByte_Aider_Setup.txt                       | Aider             | Aider users        |

--------------------------------------------------------------------------------
 3. QUICK COMPARISON
--------------------------------------------------------------------------------
  | Tool         | Install Command                          | Config Style     |
  |--------------|------------------------------------------|------------------|
  | OpenCode     | npm install -g opencode-ai               | JSON config file |
  | Codex CLI    | npm install -g @openai/codex             | TOML config file |
  | Claude Code  | npm install -g @anthropic-ai/claude-code | Env vars         |
  | Kimi Code    | npm install -g @anthropic/kimi-cli       | Env vars / JSON  |
  | Qwen Code    | npm install -g @qwen-code/qwen-code      | Env vars / JSON  |
  | Gemini CLI   | npm install -g @google/gemini-cli        | Env vars         |
  | Aider        | pip install aider-chat                   | YAML / Env vars  |

--------------------------------------------------------------------------------
 4. COMMON SETTINGS FOR ALL TOOLS
--------------------------------------------------------------------------------
  Base URL:   http://127.0.0.1:8091/v1
  API Key:    sk-sindbyte-local  (any text starting with "sk-" works)
  Protocol:   OpenAI API (compatible)

  IMPORTANT: SindByte must be running before you start any AI assistant.

--------------------------------------------------------------------------------
 5. ENVIRONMENT VARIABLE QUICK REFERENCE
--------------------------------------------------------------------------------
  | Tool         | URL Variable              | Key Variable           |
  |--------------|---------------------------|------------------------|
  | OpenCode     | (set in opencode.json)    | (set in opencode.json) |
  | Codex CLI    | OPENAI_BASE_URL           | OPENAI_API_KEY         |
  | Claude Code  | ANTHROPIC_BASE_URL        | ANTHROPIC_API_KEY      |
  | Kimi Code    | KIMI_BASE_URL             | KIMI_API_KEY           |
  | Qwen Code    | OPENAI_BASE_URL           | OPENAI_API_KEY         |
  | Gemini CLI   | GOOGLE_GEMINI_BASE_URL    | GEMINI_API_KEY         |
  | Aider        | OPENAI_API_BASE           | OPENAI_API_KEY         |

--------------------------------------------------------------------------------
 6. IQ TOOLS AVAILABILITY
--------------------------------------------------------------------------------
  | Tool         | Per-request IQ | Via Model Name | Via SindByte Config |
  |--------------|----------------|----------------|---------------------|
  | OpenCode     | No             | Yes            | Yes                 |
  | Codex CLI    | No             | Yes (iq/*)     | Yes                 |
  | Claude Code  | No             | Yes (iq/*)     | Yes                 |
  | Kimi Code    | No             | Yes (iq/*)     | Yes                 |
  | Qwen Code    | No             | Yes (iq/*)     | Yes                 |
  | Gemini CLI   | No             | No             | Yes                 |
  | Aider        | No             | Yes (openai/iq/*) | Yes              |

  To select an IQ profile via model name, use aliases like:
    LMDirect, iq/full, iq/research, iq/trading, iq/minimal, iq/off

  To set a global default, open SindByte Config and set
  API Provider -> Default IQ Profile.

--------------------------------------------------------------------------------
 7. MAKING SETTINGS PERMANENT ON WINDOWS
--------------------------------------------------------------------------------
  1. Press Win + R, type sysdm.cpl, press Enter
  2. Go to "Advanced" tab -> "Environment Variables"
  3. Under "User variables" click "New"
  4. Add the URL variable and Key variable from Section 5
  5. Restart your terminal / IDE

--------------------------------------------------------------------------------
 8. TROUBLESHOOTING ALL TOOLS
--------------------------------------------------------------------------------

  PROBLEM: "Cannot connect" or "Connection refused"
  FIX:     Make sure SindByte is running. Check the tray icon.

  PROBLEM: "Model not found"
  FIX:     Use exact SindByte aliases: LMDirect, iq/full, iq/research, etc.

  PROBLEM: "Invalid API key"
  FIX:     Use sk-sindbyte-local (must start with "sk-").

  PROBLEM: Tool ignores my custom URL
  FIX:     Make sure the environment variable is set BEFORE launching the tool.
           Close and reopen your terminal after setting env vars.

--------------------------------------------------------------------------------
 9. ADDITIONAL RESOURCES
--------------------------------------------------------------------------------
  SindByte documentation:  See AGENTS.md in project root
  Build instructions:      See PB11_COMPILATION_GUIDE.txt
  Support:                 Check MCP_Server.log after any connection attempt

================================================================================
  END OF INDEX
================================================================================
