scmd | local-first shell assistant

Your Terminal's AI Companion.

scmd brings professional AI assistance to your shell with zero API costs. Analyze code, generate commands, and automate workflows entirely on your hardware.

Get Started Free View Benchmarks

01. system_benchmarks

Engine	scmd	Copilot CLI	ChatGPT Plus	Aider
Annual Cost	$0	$120	$240	$600+
Data Locality	On-Prem	Cloud	Cloud	Cloud
Air-Gapped	✅ Native	❌ No	❌ No	❌ No
Command Logic	Man-Page Aware	General	General	Interactive
Distribution	YAML Repos	❌ No	❌ No	❌ No

02. bootstrap_sequence

# Homebrew (macOS/Linux)

brew install sunboy/tap/scmd

# NPM (Global)

npm install -g scmd-cli

💬

Multi-Turn Chat

Natural conversations with context retention. Start a session with scmd chat and iterate on complex problems.

🛠️

Man-Page Aware

AI command generation powered by your system's actual documentation. Accurate, OS-specific output every time.

🔍

Safe Review

Get expert-level code reviews instantly. Detect security vulnerabilities without sending proprietary code to the cloud.

📦

100+ Commands

Install commands like npm packages. 8 categories: git, code, devops, docs, debug, data, security, shell. scmd repo search

🎨

Beautiful Output

Syntax highlighting for 40+ languages. Markdown rendering with themes. Auto-detection for piped output.

📝

Template System

6 professional templates: security-review, performance, api-design, testing, docs, beginner-explain. Create and share custom templates.

03. practical_solves

// Case: Multi-turn conversation with context

scmd chat

You: How do I implement rate limiting in Express?
🤖 Assistant: [Detailed explanation with code]

You: What about Redis-based rate limiting?
🤖 Assistant: [Builds on previous context...]

// Case: Install community commands like npm

scmd repo search docker

official/dockerfile - Generate optimized Dockerfiles
official/compose - Create docker-compose configs

scmd repo install official/dockerfile

✓ Installed official/dockerfile v1.0.0

// Case: Professional security review with templates

scmd /review auth.js --template security-review

🔴 CRITICAL: SQL Injection vulnerability (CWE-89)
🟡 MEDIUM: Missing input validation
🟢 INFO: Consider using prepared statements

04. core_extensibility

Drop YAML templates into your home directory. SCMD builds the command index automatically. Share repositories across teams to standardize reviews.

~/.scmd/commands/api-review.yaml YAML

name: api-review

model: qwen2.5-1.5b

prompt: |

  Review this API endpoint for:

  - HTTP method correctness

  - Error handling coverage

  - Input validation

05. runtime_specs

Inference Engine llama.cpp / Ollama

Binary Size 14 MB

Context Window 8192 tokens

Models 0.5B / 1.5B / 3B / 7B

GPU Acceleration ✅ Metal / CUDA

SCMD_