Local-first AI agent orchestrator with MCP server, secure file operations, shell execution, code indexing, and quality gates
npm install sentineltm-cli



> The World's Most Advanced AI Development Orchestrator
> Enforce Zero Tolerance Quality Standards with Military-Grade Precision
Version 2.3.6 โ Critical MCP workspace bug fixed! ๐
SentinelTM (st) is a revolutionary AI-powered development guardian that transforms how you build software. Combining enterprise-grade CLI tools with cutting-edge MCP (Model Context Protocol) capabilities, it enforces uncompromising quality standards while seamlessly integrating with 20+ AI providers and 23+ IDEs.
- ๐ฏ Zero Tolerance Quality: Enforces strict coding standards with AI-powered validation
- ๐ Security-First: Sandboxed file system and controlled shell execution
- ๐ค Provider Agnostic: Works with Ollama, OpenAI, Claude, Gemini, Mistral, OpenRouter, and any OpenAI-compatible API
- ๐ Interactive Setup: Guided configuration with smart defaults
- ๐ Quality Gates: Automated code review and compliance checking
- ๐จ IDE Integration: One-command setup for VS Code, Cursor, Zed, Windsurf, and more
SentinelTM now ships built-in helpers to keep your codebase clean without extra setup.
- Format (all/common languages)
- st fmt (auto-detect) or st fmt js|ts|py|go|rs|sh|md
- Lint
- st lint (auto-detect) or st lint js|ts|py|sh
- Python helpers (Ruff)
- st py init-config โ creates pyproject.toml (and optional pre-commit)
- st py format โ ruff format .
- st py lint โ ruff check . --fix
Notes:
- Tools are used if available (e.g., prettier, eslint, ruff, gofmt, rustfmt, shfmt). If not installed, helpful guidance is shown.
- Minimal defaults, zero clutter. Use st init-config to generate minimal configs (.eslintrc.json, .prettierrc, pyproject.toml).
---
``bash`
npm install -g sentineltm-cli@latest
SentinelTM provides an interactive setup wizard for seamless configuration:
`bash`
st set provider
This will guide you through:
1. ๐ Select Provider: Choose from Ollama, OpenAI, Claude, Gemini, Mistral, or OpenRouter
2. ๐ Enter API Key: Provide your API credentials (or skip for Ollama)
3. ๐ค Select Model: Pick from available models (auto-fetched from the provider)
#### Example Providers:
Ollama (Local, Free)
`bashInstall Ollama first: https://ollama.ai
ollama pull llama3
OpenRouter (Best for Production)
`bash
st set provider
โ Select: openrouter
โ API Key: sk-or-v1-xxxxx
โ Model: deepseek/deepseek-chat or x-ai/grok-2-latest
`OpenAI
`bash
st set provider
โ Select: openai
โ API Key: sk-xxxxx
โ Model: gpt-4-turbo
`$3
Configure your development environment with one command:
`bash
st set ide
`This will:
1. โ
Select IDEs: Choose from VS Code, Cursor, Zed, Windsurf, Continue, Cline, etc.
2. ๐ค Configure Provider: Select AI provider and model (if not already set)
3. ๐ Apply Rules: Optionally apply Zero Tolerance coding standards
$3
`bash
Check provider status
st provider statusRun quality gate
st gate run
`---
๐ Command Reference
$3
| Command | Description |
|---------|-------------|
|
st set provider | Interactive setup for AI provider (recommended) |
| st provider configure | Alternative interactive setup command |
| st provider set | Set existing provider as default |
| st provider list | List available models from provider |
| st provider status | Show current provider and model |
| st provider detect | Auto-detect available providers |$3
| Command | Description |
|---------|-------------|
|
st set ide | Interactive IDE setup (recommended) |
| st ide set [names...] | Configure specific IDEs |
| st ide list | List all supported IDE targets |Supported IDEs: VS Code, Cursor, Zed, Windsurf, Continue, Cline, Codex, Claude, Gemini, OpenCode, Roo, Amp, Kilo, Trae, Kiro
$3
| Command | Description |
|---------|-------------|
|
st gate run | Run all quality checks |
| st gate run --min 90 | Run with custom passing score |Built-in Checks:
- ๐งช Tests
- ๐จ Linting & Formatting
- ๐๏ธ Build Verification
- ๐ Security Scan
- ๐ Project Structure
- ๐งน Code Hygiene
- ๐ค AI Rule Check (enforces Zero Tolerance standards)
$3
| Command | Description |
|---------|-------------|
|
st fs ls [path] | List files and directories |
| st fs read | Read file contents |
| st fs write | Write to file |
| st fs search | Search across codebase |$3
| Command | Description |
|---------|-------------|
|
st index build | Build code index |
| st index status | Show index statistics |
| st index search | Search indexed code |$3
| Command | Description |
|---------|-------------|
|
st dashboard report | Full project health report |
| st dashboard metrics | Key metrics summary |
| st status | Quick project overview |$3
| Command | Description |
|---------|-------------|
|
st task list | List all tasks |
| st task add | Create new task |
| st task done | Mark task as complete |---
๐ฏ Zero Tolerance Contract
SentinelTM enforces strict coding standards through its Zero Tolerance Contract system:
- โ
Type safety and hints required
- โ
No hardcoded values (strings, numbers, URLs)
- โ
Configuration externalized to YAML
- โ
Modular architecture (max 300 lines per file)
- โ
PEP8/ESLint compliance
- โ
Comprehensive error handling
- โ
Security best practices
See ZERO_TOLERANCE_CONTRACT.md for full details.
---
๐ง Configuration
All configuration is stored in
.sentineltm/config/config.json:`json
{
"defaults": {
"provider": "openrouter",
"model": "deepseek/deepseek-chat"
},
"providers": {
"openrouter": {
"type": "openai-compatible",
"baseURL": "https://openrouter.ai/api",
"apiKey": "sk-or-v1-xxxxx"
}
}
}
`---
๐ Advanced Guides
- API Integration Guide - Deep dive into provider configuration
- Zero Tolerance Contract - Complete coding standards
- MCP Server Usage - Using SentinelTM as an MCP server
---
๐ Troubleshooting
Provider not working?
`bash
st provider status # Check configuration
st provider detect # Auto-detect available providers
`IDE configuration not applying?
`bash
st ide list # Check supported IDEs
st set ide # Re-run interactive setup
`Quality gate failing?
`bash
st gate run --min 70 # Lower threshold for testing
``---
We welcome contributions! Please:
1. Fork the repository
2. Create a feature branch
3. Submit a pull request
---
ISC License ยฉ 2025 Amin Azmoodeh