🐻 GnouGo : The Friendly Bear Agent
> [!WARNING]
> WORK IN PROGRESS — features, APIs, and project structure may still change.
GnouGos have existed forever — they are extremely kind, a little magical, and always appear at the right moment.
They possess an enormous amount of knowledge.
For them to help you, you will need to explain clearly what you want. They won't always understand on the first try,
so take the time to re-explain.
Give them clear and simple instructions and they will provide you with invaluable services.
Their main objective: your safety and saving you time!
> ⚠️ GnouGo can make mistakes. That's okay! Forgive him and rephrase your instructions more clearly. He learns better when you talk to him nicely. The more precise you are, the more effective he'll be.
📦 Install gnougo
Windows:
winget install GnOuGo.Agent
macOS:
brew update
brew tap gnougo/tap
brew install --cask gnougo
# To run GnOuGo
sudo xattr -r -d com.apple.quarantine /Applications/GnOuGo.app
open /Applications/GnOuGo.app
Generic Linux:
Download the gnougo-linux-*.tar.gz archive from the GitHub Release first, then run:
tar -xzf gnougo-linux-x64.tar.gz
sudo install gnougo /usr/local/bin/gnougo
Ubuntu/Debian:
Download the matching .deb package from the GitHub Release first, then run:
sudo apt install ./gnougo_*_amd64.deb
You can also download the Windows, macOS, and Linux archives from the GitHub Releases page.
Standalone ProxyCopilot on macOS
Install the local VS Code Chat/Agent proxy independently of the desktop application
on Apple Silicon or Intel Macs:
brew update
brew install gnougo/tap/gnougo-proxy-copilot
# To run ProxyCopilot (foreground; Ctrl+C to stop)
gnougo-proxy-copilot
If macOS blocks the executable because it is quarantined, first verify that it
came from the official tap, then remove the quarantine attribute from that
installed binary only and run it again:
xattr -d com.apple.quarantine "$(brew --prefix gnougo-proxy-copilot)/libexec/GnOuGo.ProxyCopilot.Server"
gnougo-proxy-copilot
No sudo or .NET runtime is required. From another terminal, open the dashboard:
open http://127.0.0.1:5087/ui/
Follow the
ProxyCopilot configuration instructions.
Downloads
> Download badges below track GitHub Release asset downloads. They are useful distribution metrics, but they are not strict Winget/Homebrew install counters.
| Distribution | Package | Version / Availability | Latest release downloads | Total downloads |
|---|
| GitHub Release | Latest release |  |  |  |
| Windows | GnOuGo.Agent via Winget |  |   |   |
| macOS | gnougo via Homebrew Cask |  |   |   |
🧱 Project Building Blocks
The GnOuGo project is composed of several complementary families:
| Family | Description |
|---|
| GnOuGo.Agent | End-user chat experience: local web app, desktop host, and shared contracts for the main assistant UI. |
| GnOuGo.Flow | Workflow automation platform: DSL execution engine, CLI/server hosting, browser automation, command execution, and workflow user data. |
| GnOuGo.Diff | Audit and comparison tools: revision storage, diff computation, API, UI, and sample-data utilities. |
| GnOuGo.DocIngestor | Document ingestion pipeline: extract, chunk, embed, and expose documents through CLI and server components. |
| GnOuGo.KeyVault | Secret management services: encrypted storage, tenant-aware vault features, and management APIs. |
| GnOuGo.OtlpCollector | OpenTelemetry ingestion stack: multi-tenant OTLP collection plus tooling to send and inspect telemetry data. |
| GnOuGo.Assets | Deterministic, themeable GnOuGo mascot SVGs and workflow animation scenes through the independently packaged Bears and Animation libraries. |
| GnOuGo.ProxyCopilot | Standalone local LLM proxy for VS Code Chat/Agent mode, with OIDC, typed provider configuration, native protocol adapters, and a live React traffic dashboard. |
Supporting libraries such as GnOuGo.AI.Core and GnOuGo.Auth.Core provide shared AI and authentication foundations across these families.
The current dependency security review and documented upstream exceptions are maintained in DEPENDENCY_AUDIT.md.
🔌 MCP Servers
| Server | Transport | Description |
|---|
| GnOuGo.Agent.Mcp | HTTP | Agent definitions, chat history, and user configuration (default LLM, default agent). |
| GnOuGo.KeyVault.Mcp | HTTP | Encrypted secret storage: tenant management, create/read/update/delete secrets. |
| GnOuGo.Browser.Mcp | stdio | Web navigation via Playwright: open pages, click, fill forms, screenshot, and more. |
| GnOuGo.Cmd.Mcp | stdio | Safe shell command execution through a strict allowlist (deny-by-default, cross-platform). |
| GnOuGo.GithubCopilot.Mcp | stdio | Local code operations: read files, search text, summarize a project, and suggest changes via GitHub Copilot. |
| GnOuGo.Git.Mcp | stdio | Git repository workflows: status, diff, branches, commits, clone, fetch, pull, push, merge, and conflicts. |
| GnOuGo.Document.Mcp | stdio | Read and write office/text documents (PDF, DOCX, XLSX, PPTX, Markdown, CSV, JSON…). |
| GnOuGo.DocIngestor.Mcp | HTTP | Document ingestion pipeline: download, chunk, embed into a vector store, and semantic search. |
💬 GnOuGo.Agent.Server Slash Commands
Slash commands are typed in the GnOuGo.Agent.Server chat input. They are case-insensitive.
| Command | Description |
|---|
/help | Show the chat and configuration command overview. |
/status | Display the current LLM, embedding, MCP, and agent configuration summary. |
/llm | Show LLM provider command help. |
/llm list | List configured LLM providers. |
/llm models | List live models for a configured LLM provider. |
/llm add | Configure a new LLM provider. |
/llm default [name] | Set or change the default LLM provider and model. |
/llm edit | Edit an existing LLM provider. |
/llm remove | Remove an LLM provider. |
/embedding | Show embedding model command help. |
/embedding list | List configured embedding models. |
/embedding add | Configure a new embedding model. |
/embedding default [name] | Set or change the default embedding model. |
/embedding edit | Edit an embedding model configuration. |
/embedding remove | Remove an embedding model configuration. |
/mcp | Show MCP server command help. |
/mcp list | List configured MCP servers. |
/mcp add | Add a new MCP server. |
/mcp edit | Edit an existing MCP server. |
/mcp remove | Remove an MCP server. |
/gnougo | Show agent management command help. |
/gnougo list | List configured agents. |
/gnougo add | Create a new agent with the interactive wizard. |
/gnougo edit | Edit an existing agent. |
/gnougo remove | Remove an agent. |
/gnougo select | Set the active chat agent. |
📚 Published Libraries
The current GnOuGo release publishes these reusable libraries and packages:
