Command wrapper MCP server for coding agents, compression, workflows, and local automation.
io.github.PsYcGoD/sage MCP Server
The MCP server is a command-wrapper for coding agents, aimed at compression, workflows, and local automation. It exposes tooling for developer interaction via command-line usage. The project is described as “SAGE - Smart Agent Guidance Engine,” and it includes Python 3.10+ support, along with PyPI and npm distribution.
🛠️ Key Features
Command wrapper MCP server
Supports compression, workflows, and local automation
Topics include AI agents, automation, CLI, developer tools, DevOps, and productivity
Emphasizes token savings
🚀 Use Cases
Coding agent guidance and execution via CLI
Automating local tasks and workflow steps
Incorporating compression into agent-driven processes
⚡ Developer Benefits
Built for coding agents and command-line environments
Cross-ecosystem availability (PyPI and npm mentioned)
Includes Python 3.10+ baseline
⚠️ Limitations
No tool count or specific MCP tools are provided in the available server data.
SAGE is a local-first command wrapper for AI coding agents. It keeps full terminal output on your machine, sends agents a clean compressed summary, and tracks proof metrics without uploading your raw logs.
Use it with Claude Code, Codex, Cursor, Windsurf, OpenCode, Cline, custom agents, CI scripts, and normal terminal workflows.
Start Here: Install SAGE, Use once sage run -- python -m pytest, Then Use Any AI Agent
Package installation is passive for package-registry safety. After installing, run sage install once to activate SAGE for supported local AI agents.
PyPI / pip
powershell
pip install psycgod-sage
# or
python -m pip install --upgrade psycgod-sage
sage install
sage run -- python -m pytest
npm / npx
bash
npm install -g psycgod-sage
npx -y psycgod-sage install
npx -y psycgod-sage run -- npm test
After install, restart any open AI-agent sessions. New sessions should read the SAGE instructions automatically and route terminal commands through SAGE.
Example prompt after restarting your AI agent:
text
Please help me with my general book in this folder.
Natural shortcuts also work:
bash
sage pytest
sage npm test
sage git status
These are treated as:
bash
sage run -- pytest
sage run -- npm test
sage run -- git status
What SAGE Does
Step
Result
sage install
Activates the machine locally, repairs global/project agent instructions, and verifies activation
sage run -- <command>
Runs the command, stores raw output locally, and returns a compact useful summary
Agent memory/hooks
Tell supported AI agents to use SAGE for noisy terminal work
Local database
Keeps command history, compression proof, and retry context on the user's machine
Local proof
Keeps command and compression metrics on the user's machine
SAGE does not auto-enable MCP. MCP is optional and manual for users who want it.
Recorded Local Metrics
Latest pulled stats as of 2026-08-01:
Metric
Value
SAGE telemetry command events
27,892
Tokens processed
799.5M
Tokens saved
783.7M
Compression rate
98.02%
Estimated savings
$16,261.90
Command success rate
88.3%
PyPI downloads, last 7 days
632
npm downloads, last 7 days
362
GitHub clones, last 14 days
574
Why It Helps
AI coding agents burn context on repeated logs, failed test output, install noise, stack traces, and build spam. SAGE sits between the command and the agent.
The npm package delegates to the Python implementation so both install paths use the same local database, telemetry rules, compression, and command behavior.
Common Commands
bash
sage install # Activate this machine and AI-agent instructions
sage doctor --activation # Verify activation
npx -y psycgod-sage doctor --activation
sage run -- <command> # Wrap any command
sage run --cwd /project -- <command> # Explicit workspace for host integrations
sage pytest # Shortcut for: sage run -- pytest
sage npm test# Shortcut for: sage run -- npm test
sage git status # Shortcut for: sage run -- git status
sage context stats # Token savings summary
sage context report # Full compression report
sage history --limit 10 # Recent command history
sage explain --failed # Explain the latest failed command
sage suggest --failed # Suggest the next fix
sage fix --apply # Try an automatic fix
sage ml setup # Optional ML V2 dependencies
sage mcp install # Optional/manual MCP config
sage dashboard start # Local dashboard
Privacy Modes
Mode
Requires login?
Sends data?
What leaves the machine?
Local-only
No
No
Nothing
Debug telemetry
Optional
Opt-in only
Redacted diagnostic summaries
SAGE is designed to keep prompts, source code, credentials, raw command output, and project files local unless the user deliberately enables a feature that requires sending data.
Known Limitations
Limitation
What To Do
Already-open AI-agent sessions may not reload new instructions
Restart Claude/Codex/Cursor/Windsurf/OpenCode after sage install
Locked-down host apps can disable shell tools
SAGE cannot enable tools the host application has blocked
A host starts its shell in the wrong folder
Pass sage run --cwd <project> -- <command> or set SAGE_WORKSPACE_CWD