Obsidian Next

This README was written by Obsidian (v0.4.8) - a global, always-on autonomous engineering daemon with adaptive reasoning and system-wide persistent memory.

Obsidian Next is a global, always-on autonomous engineering partner. It runs as a system-wide background service, managing multiple codebases and performing proactive engineering tasks while you're away.

Built for engineers who need an agent that lives in their system - not just in a terminal window.

What Makes Obsidian Autonomous

| Feature | Obsidian Next | Other Assistants | |---------|---------------|------------------| | Lifecycle | Always-on Daemon (Service) | Script / Process-bound | | Intelligence | Adaptive Multi-Provider Engine | Single Model / Provider | | Reasoning | Claude 4.6 Adaptive Thinking | Standard Chat | | Context | 1 Million Token Mastery | 128k - 200k fixed | | Memory | Semantic Vector Store (Hybrid) | Simple Chat History | | Proactivity | Heartbeat Background Tasks | Reactive Only | | Scope | Global (System-wide) | Project-locked |

Quick Start

# Install globally
npm install -g @aurora-foundation/obsidian-next

# Initialize global daemon and services
obsidian init --service

# Check daemon status
obsidian status

Core Capabilities

Always-On Autonomy

Obsidian runs as a background service (launchd or systemd). It doesn't die when you close your terminal. It keeps reasoning, indexing, and auditing in the background.

Adaptive Multi-Provider Engine

Seamlessly switch between Anthropic Claude 4.6 and local Ollama models. Obsidian intelligently routes tasks based on complexity, cost, and availability.

1M Token Context window

Hold entire repositories in active memory. Obsidian uses Prompt Caching and Context Distillation to keep massive windows cheap, fast, and coherent.

Proactive Heartbeat (The Scheduler)

Schedule background tasks to keep your systems healthy:

• Nightly Audits: Scan for security vulnerabilities or dead code.
• Auto-Documentation: Generate docstrings for new functions.
• Health Checks: Run tests and notify you via Telegram if they break.

/schedule "0 2 * * *" system:audit
/schedule "*/30 * * * *" system:sync_index

Self-Improving Skills

Obsidian can autonomously expand its own toolbox. If it hits a capability gap, it writes, tests, and registers a new TypeScript tool in ~/.obsidian-next/skills/ without a restart.

Commands

| Command | Description | |---------|-------------| | /schedule | Manage proactive background tasks | | /memory | Export/sync the Semantic Knowledge Bank | | /workspace| Focus the agent on a specific project root | | /pilot | Secure GUI automation (Computer Use) | | /status | Monitor daemon health and 1M context usage | | /resume | Restore sessions from any workspace |

Keyboard Shortcuts

| Shortcut | Action | |----------|-------------| | Shift+Tab| Cycle between Direct, Plan, and Safe modes | | PageUp | Scroll up through chat history | | PageDown | Scroll down through chat history | | Ctrl+T | Open/close Task View | | Ctrl+K | Open Command Palette | | Escape | Interrupt active agent execution |

Architecture (The Gateway Pattern)

Obsidian Next operates via a central backend service connected to multiple frontends:

graph TD
    subgraph "Interfaces"
        CLI[CLI Frontend]
        TG[Telegram Bot]
        Web[Web UI]
    end

    subgraph "Always-On Daemon (Backend)"
        Socket[Unix Domain Socket] <--> LaneQueue[Lane Queue]
        LaneQueue <--> Agent[Agent Core]
        Agent <--> MultiProvider[Multi-Provider Engine]
        Agent <--> Tools[Self-Improving Tools]
    end

    subgraph "System State (~/.obsidian-next/)"
        DB[(SQLite state.db)]
        Vector[Semantic Memory]
        MD[MEMORY.md / Logs]
    end

    CLI <--> Socket
    TG <--> Socket
    Web <--> Socket
    Agent <--> DB

Security & Safety

• Global Auditor: Centralized security policy for all projects.
• Lane Queue: Prevents race conditions during concurrent access.
• Visual Privacy Guard: Redacts sensitive data from screenshots in Pilot Mode.
• Kill Switch: Immediate local or remote termination of all autonomous activity.

Documentation

| Resource | Description | |----------|-------------| | Master Plan | The Autonomous Roadmap | | Architecture | The Daemon & Gateway System | | Smart Context | 1M Token & Semantic Memory | | Security Policy | Global Zero Trust Model |

Development

npm run dev      # Watch mode
npm run build    # Build daemon and frontend
npm test         # Full suite (vitest)

License

Copyright 2026 Aurora Foundation. Licensed under AGPL-3.0.