UncleStans

Multi-provider AI coding CLI — Claude, GPT-4o, Gemini, DeepSeek, Ollama and more.

Inspired by Claude Code. Built with TypeScript and Bun.

Requirements

• Bun v1.2.0 or later

Installation

npm install -g uncle-stans
# or
bun install -g uncle-stans

Quick Start

# Interactive REPL
uncle-stans

# Single prompt (CI mode)
uncle-stans --print "explain this codebase" --yes

# Use a specific model
uncle-stans --model gpt-4o
uncle-stans --model gemini-3.1-pro
uncle-stans --model llama3.3  # local via Ollama

Provider Setup

UncleStans resolves providers in this order:

1. Replit AI Integrations — automatic when running on Replit (no key needed)
2. BYOK — set any of these environment variables:

   ANTHROPIC_API_KEY=sk-ant-...
   OPENAI_API_KEY=sk-...
   GOOGLE_API_KEY=AIza...
   DEEPSEEK_API_KEY=...

3. Ollama — runs locally at http://localhost:11434, zero cost

18 Tools

| Tool | Permission | |---|---| | FileReadTool | auto | | FileWriteTool | ask | | FileEditTool | ask | | BashTool | ask | | GlobTool | auto | | GrepTool | auto | | WebFetchTool | auto | | WebSearchTool | auto | | AgentTool | ask | | TodoWriteTool | auto | | MemorySaveTool | auto | | MemorySearchTool | auto | | MemoryListTool | auto | | MemoryDeleteTool | ask | | SkillTool | auto | | SkillListTool | auto | | SendMessageTool | auto | | NotebookEditTool | ask |

Slash Commands

| Command | Description | |---|---| | /help | Show all commands | | /model [name] | Show or switch active model | | /status | Provider and model info | | /cost | Session cost summary | | /clear | Clear conversation history | | /memory | List saved memories | | /skills | List available skills | | /agents | List, inspect, or kill sub-agents | | /commit | Review staged changes and commit | | /review [PR#] | Structured PR review | | /save [name] | Save current session | | /load [name] | Load a saved session | | /compact | Compress conversation history | | /config [k v] | Read or write config | | /permissions | Read or write permission rules | | /mcp | Manage MCP server configuration | | /init | Generate UNCLE.md for current project | | /vim | Toggle vim keybinding mode |

Memory

UncleStans remembers context across sessions using SQLite (via Bun's built-in bun:sqlite). Memories are scoped per-user and per-project.

# Stored at:
~/.uncleStans/memory/     # user scope (all projects)
.uncle-stans/memory/      # project scope (current repo)

Skills

Create reusable prompt workflows as Markdown files:

---
name: deploy
description: Deploy to production
execution: inline
args: [environment]
---
Run the deployment pipeline for {{environment}}...

# Store at:
~/.uncleStans/skills/     # global
.uncle-stans/skills/      # project-local

Configuration

# Context file (place in any project root)
UNCLE.md

# Config
~/.uncleStans/config.json

# Permissions
~/.uncleStans/permissions.json

Environment Variables

| Variable | Default | Description | |---|---|---| | UNCLE_STANS_DEFAULT_MODEL | claude-sonnet-4-5 | Active model | | UNCLE_STANS_PERMISSION_MODE | ask | auto, ask, or deny | | FIRECRAWL_API_KEY | — | Web search via Firecrawl | | OLLAMA_BASE_URL | http://localhost:11434 | Local Ollama endpoint |

License

MIT