npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

grok-bot-setup

v1.3.0

Published

CLI to point Grok Bot at custom model providers (DeepSeek, Claude, Grok, OpenAI, …)

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

blockedredemptionblockedredemption

Keywords

grokxaiadaptersclillmopenai-compatible

Readme

grok-bot-setup

CI npm npm downloads license node platform cli bash GitHub

CLI to point Grok Bot at custom model providers — DeepSeek, Claude, Grok, OpenAI, OpenRouter, ChatGPT/Codex, or any OpenAI-compatible URL.

npm install -g grok-bot-setup
adapters

Grok Bot Inference Adapters interactive menu

Install

npm (recommended)

# one-shot
npx grok-bot-setup

# global (puts `adapters` on PATH)
npm install -g grok-bot-setup
adapters help

Also available as the grok-bot-setup command (same CLI).

Other ways

curl -fsSL https://raw.githubusercontent.com/BlockedPath/grok-bot-setup/main/adapters.sh \
  -o ~/.local/bin/adapters
chmod +x ~/.local/bin/adapters
git clone https://github.com/BlockedPath/grok-bot-setup.git
cd grok-bot-setup
./adapters

Quick start

# 1) Install optional proxies + login CLIs (as needed)
adapters install all
adapters install login-agents

# 2) Log in to the providers you care about
claude login    # Claude Pro/Max OAuth
grok login      # Grok session
codex login     # ChatGPT / Codex OAuth

# 3) Point Grok Bot at a provider
adapters use deepseek
# or: claude | grok-session | openai | openrouter | xai-api | litellm | openai-oauth | direct | cursor

# 4) Check status anytime
adapters status

Or just run adapters with no args for the interactive menu.

Prerequisites

  • Sand / Grok Bot host (~/sand-host, ~/sand-data)
  • bash, curl, python3
  • Only if you use that adapter:
    • CLIProxy (Claude OAuth) → Go
    • LiteLLM bridge → uv
    • openai-oauth (Codex) → Node / npx

Commands

| Command | What it does | |---------|----------------| | adapters | Interactive menu | | adapters status | Current provider + adapter ports | | adapters check-logins | Claude / Grok / Codex CLI login state | | adapters effort high\|medium\|low\|xhigh\|off | Set reasoning effort (restarts host) | | adapters install [target] | Download adapters or login CLIs | | adapters start [target] | Start local proxies | | adapters stop [target] | Stop local proxies | | adapters use <profile> | Switch Grok Bot provider | | adapters restart-host | Restart Sand host to pick up config | | adapters help | Full help |

Install targets

all · cliproxy · litellm · openai-oauth · claude · grok · codex · login-agents

Start / stop targets

all · cliproxy (:8317) · litellm (:4000) · openai-oauth (:10531)

Provider profiles (adapters use …)

| Profile | Backend | Auth | |---------|---------|------| | deepseek | api.deepseek.com | DeepSeek API key | | claude / cliproxy | CLIProxy :8317 or LiteLLM | claude login or Console API key | | grok-session / grok | Grok cli-chat-proxy | grok login | | xai-api / xai | api.x.ai | xAI API key | | openai | OpenAI Platform | OPENAI_API_KEY | | openrouter | OpenRouter | OPENROUTER_API_KEY | | litellm / bridge | LiteLLM :4000 | master key in bridge .env | | openai-oauth / codex | openai-oauth :10531 | codex login | | direct | Any OpenAI-compatible URL | --base-url + --key + --model | | cursor / stock | Stock Cursor path | disables custom provider |

Flags

adapters use deepseek --model deepseek-chat --key sk-...
adapters use claude --model claude-opus-5 --oauth --thinking enabled --reasoning-effort medium
adapters use grok-session --model grok-4.6 --effort high
adapters use grok-session --model grok-4.6 --effort medium   # safer multi-agent / groups
adapters effort medium                                       # change effort only
adapters use openai --model gpt-4o --key sk-...
adapters use direct --base-url https://example.com/v1 --model my-model --key KEY
  • --model ID — skip model prompt
  • --key KEY — skip API-key prompt (or use env vars like OPENAI_API_KEY)
  • --auth oauth|api_key — Claude auth mode
  • --thinking enabled|disabled — model thinking / chain-of-thought (writes SAND_XAI_THINKING)
  • --effort / --reasoning-effort low|medium|high|xhigh — writes SAND_XAI_REASONING_EFFORT
  • --thinking medium — shorthand for enabled + effort medium (also low / high)
  • --no-restart — write config without restarting the host

Multi-agent safety (host module)

Patched in ~/sand-host/xai-prompt-session.cjs:

| Env | Default | Meaning | |-----|---------|---------| | SAND_XAI_MAX_TOKENS | 8192 | Cap completion length (0 = omit) | | SAND_XAI_PROMOTE_REASONING | off | Do not re-inject reasoning as normal chat content (stops monologue loops) |

For group chats prefer: adapters effort medium

What it writes

| Path | Purpose | |------|---------| | ~/sand-data/xai-inference.env | Active provider config (loaded by the host) | | ~/sand-data/settings.json | agentDefaultModel (when switched) | | ~/.local/share/grok-bot-adapters/ | Local proxy trees from adapters install |

Override the local data dir with ADAPTERS_DATA=/path.

Docs

Contributing