ShellForge โ€” Forge Local AI Agents

Forge Local AI Agents.
Governed.

Govern any AI coding agent โ€” local or cloud. One policy across Goose, Claude Code, Copilot, Codex, and Gemini. Mac with local models. Linux server with API drivers. Your rules, everywhere.

Open Source ยท MIT License ยท macOS ยท Linux ยท Any GPU
$ brew tap AgentGuardHQ/tap
$ brew install shellforge
$ shellforge setup
โ”€โ”€ Step 1/6: Ollama โ”€โ”€
โœ“ Ollama running
โœ“ Model ready: qwen3:8b
โ”€โ”€ Step 2/6: Governance โ”€โ”€
โœ“ agentguard.yaml created (enforce, 3 policies)
โ”€โ”€ Step 3/6: Dagu โ”€โ”€
โœ“ Dagu installed
Setup Complete

$ shellforge agent "find test gaps in this repo"
[governance] loaded โ€” enforce, 3 policies
[intent] list_files via json_block
[governance] allow | list_files
[intent] read_file via json_block
[governance] allow | read_file
[intent] run_shell via json_block
[governance] DENY | rm -rf / (destructive)
[correction] sending feedback to model...
[intent] run_shell via json_block
[governance] allow | go test ./...
done โ€” 4 turns, 4 tool calls, 1 denial corrected

$ shellforge run claude "review open PRs"
[governed] Claude Code with AgentGuard hooks

Every Agent. Every Action. Governed.

Local models on your Mac. API drivers on your server. One governance layer for all of it.

๐Ÿฆ™

Any Model, Any Provider

Local via Ollama (qwen3, mistral, phi4) on Mac/GPU Linux. Or use Claude, Copilot, Codex, Gemini APIs on headless servers. ShellForge governs them all.

๐Ÿ›ก๏ธ

AgentGuard Governance

Policy-as-code in agentguard.yaml. Block force-push, restrict file writes, enforce timeouts. Monitor mode โ†’ enforce mode when ready.

โšก

Single Binary. No Daemons.

One Go binary, zero dependencies. Each agent command runs and exits. Cron-safe. No background processes, no distributed systems, no complexity.

๐Ÿง 

Memory-Optimized

RTK strips 70-90% of terminal noise before the LLM sees it. KV cache quantization doubles agent capacity on 8GB Macs.

๐Ÿ”Œ

Multi-Driver Governance

Govern any CLI agent โ€” Goose (local), Claude Code, Copilot CLI, Codex, Gemini. One governance policy across all drivers.

๐Ÿ”„

Dagu Orchestration

shellforge swarm โ€” YAML DAG workflows with web dashboard. Schedule agents, define dependencies, run a 24/7 swarm on your Mac or Linux box.

Where AgentGuard Lives

Between every tool call and your environment. The gatekeeper.

INPUT ๐Ÿ“ Your Prompt Natural language task or command
โ†“
COMPRESS โšก RTK Rust Token Killer โ€” strips 70-90% of noise
โ†“
QUANTIZE ๐Ÿง  TurboQuant 6x KV cache compression for large models
โ†“
INFER ๐Ÿฆ™ Ollama Local inference ยท qwen3 ยท mistral ยท any GGUF
โ†“
EXECUTE ๐Ÿ’ป Goose โ€” AI Coding Agent Native Ollama support โ€” reads, writes, edits, runs commands
โ†“
GOVERN ๐Ÿ›ก๏ธ AgentGuard โ€” The Gateway allow / deny / audit every action before it reaches your machine
โ†“
EXECUTE ๐ŸŒ Your Environment Filesystem ยท Shell ยท Git ยท Network ยท APIs
โ†“
SCAN ๐Ÿพ DefenseClaw Cisco supply chain security โ€” scan skills, verify MCP servers
โ†“
SANDBOX ๐Ÿ”’ OpenShell NVIDIA kernel isolation โ€” Landlock + Seccomp

Governed Drivers

One governance policy. Any CLI agent. Every tool call checked.

Driver Command Model Status
Goose shellforge run aider Local (Ollama) governed
Claude Code shellforge run claude Claude API governed
Copilot CLI shellforge run copilot GitHub Copilot governed
Codex CLI shellforge run codex OpenAI coming soon
Gemini CLI shellforge run gemini Google coming soon
Built-in shellforge agent Local (Ollama) works now

The Full Stack

Seven technologies. One governed agent runtime. Here's how they fit together.

INPUT ๐Ÿ“ Your Prompt "Analyze this repo for test gaps"
โ†“
COMPRESS โšก RTK (Rust Token Killer) Strips 70-90% of terminal noise before the LLM sees it
โ†“
MODEL ๐Ÿฆ™ Ollama Local inference โ€” qwen3, mistral, any GGUF model
โ†“
EXECUTE ๐Ÿ’ป Goose (Block) AI agent with native Ollama support โ€” actually executes shell, files, git
โ†“ agent wants to: write file, run shell, push git
GOVERN ๐Ÿ›ก๏ธ AgentGuard โ€” The Gateway Policy-as-code โ€” allow/deny every action before it touches your environment
โ†“ approved actions only
EXECUTE ๐ŸŒ Your Environment Filesystem ยท Shell ยท Git ยท Network ยท APIs โ€” the real world
โ†“
SCAN ๐Ÿพ DefenseClaw (Cisco, RSA 2026) Supply chain security โ€” scan skills, verify MCP servers, AI BoM
โ†“
SANDBOX ๐Ÿ”’ OpenShell (NVIDIA, GTC 2026) Kernel-level isolation โ€” Landlock + Seccomp, signed audit logs

ShellForge

Governed runtime
The control layer

Goose

AI coding agent
Executes the work

AgentGuard

Governance kernel
Enforces policy

Ollama

Local LLM inference
Powers the model

RTK

Token compression
70-90% fewer tokens

Dagu

Workflow orchestration
Schedules the swarm

OpenShell

Kernel sandbox
Isolates the process

Goose executes. AgentGuard governs. Ollama infers.
RTK compresses. Dagu orchestrates. OpenShell sandboxes.

All open source. All local. All on your Mac.

Star the repo to follow along.

Get Started in 60 Seconds

Install. Setup. Forge.

$ brew tap AgentGuardHQ/tap
$ brew install shellforge
$ shellforge setup
$ shellforge agent "analyze this repo for test gaps"