Cognithor: A Local-First Agent OS with PGE Trinity Architecture
Cognithor is a fully local, autonomous Agent OS developed over one year through 16 distinct phases. The project emphasizes deliberate architecture, documented decisions, and substantial test coverage, distinguishing it from what the creator calls "vibe-coded" AI projects.
Core Architecture: PGE Trinity
Every task in Cognithor flows through a three-gate system: Planner → Gatekeeper → Executor. The Gatekeeper is deterministic, enforcing policy before execution rather than after, creating a control layer beyond simple agent chaining.
Technical Specifications
- Codebase: >118,000 LOC source, >108,000 LOC test
- Testing: 11,609+ tests with 89% coverage, 0 lint errors
- LLM Support: 16 providers including Ollama, LM Studio, Anthropic, OpenAI, Gemini, and 11 others
- Channels: 17 interfaces including Telegram, Discord, Slack, WhatsApp, Signal, Voice, CLI, and WebUI
- Tools: 123 MCP tools
- Features: Computer Use, Deep Research v2 (25-round iterative), SSH remote execution, VS Code extension
- Memory: 5-tier cognitive memory system
- Security: GDPR-compliant with Ed25519-signed audit trail
Local-First Implementation
The system operates with no cloud requirements and no mandatory API keys. All data remains on the user's machine, with Ollama or LM Studio running the brain. Cloud providers are available as opt-in alternatives.
Development Phases
The 16 completed phases include foundation (PGE, MCP, CLI), multi-agent collaboration, GDPR toolkit, distributed workers, and a Flutter Command Center. Each phase is documented, tested, and shipped.
The project is developed primarily by one developer with assistance from a tester in Budapest who validates the system on fresh machines. The developer notes that "AI writes the code. I engineer the system."
The GitHub repository is available at Alex8791-cyber/cognithor, with v1.00.0 expected to be released soon.
📖 Read the full source: r/LocalLLaMA
👀 See Also
Native macOS MCP Server for Full OS Control
A native macOS server provides 24 tools for pixel-accurate clicks, key combos, drag-and-drop, app management, multi-display support, and clipboard access. It's open source and works with Claude Code, Cursor, or any MCP client.
Autonomous coding workflow ships 163K lines overnight using Claude Code
A developer built an autonomous workflow that completed 72 tasks overnight, generating 163,643 lines of code and 6,400+ passing tests with an 85% first-attempt success rate.
Lucas Gerads demonstrates MCP servers for oscilloscope and SPICE simulator integration with Claude Code
Lucas Gerads built MCP servers for his LeCroy oscilloscope and SPICE simulator, enabling Claude Code to validate SPICE circuits and models, handle embedded programming, and automate data analysis tasks like time axis normalization and data alignment.
nah: A context-aware permission guard for Claude Code
nah is a PreToolUse hook that intercepts every tool call in Claude Code, classifying commands by action type like filesystem_read or git_history_rewrite and applying policies based on context. It runs a deterministic classifier in milliseconds with optional LLM escalation for ambiguous cases.