ArnOS

Your life, conversational.

ArnOS is a comprehensive personal operating system you control through natural language with Claude. Manage todos, habits, journal, CRM, projects, learnings, and ideas - all connected, all conversational.

---

The Problem

You collect content but never do anything with it:

• Save 50 articles to Readwise
• Read highlights occasionally
• Nothing becomes action
• Knowledge disappears in chat history

---

The Solution: 4-Step System

1. CAPTURE (Readwise, web clipper, voice notes) Save anything worth engaging with

2. PROCESS (Claude + ArnOS) Extract learnings, insights, patterns Structure knowledge, don't just collect

3. ACT (ArnOS) Create todos from insights Build projects from ideas Track habits from learnings

4. SHARE (X, LinkedIn) Turn your learnings into content Build in public, share insights

Every article becomes:

• Knowledge in your system
• Actions on your list
• Content for your audience

Zero waste.

---

Features

Core Productivity

• Todos - Natural language task management across projects
• Habits - Daily tracking with streak visualization
• Journal - Voice or text entries with full-text search
• Projects - Track ventures, goals, progress
• CRM - Manage relationships, deals, follow-ups

Knowledge Management

• Learnings - Capture insights from reading, conversations, experiences
• Ideas - Never lose a thought, tag and search everything
• Universal Search - Find anything across all domains

Works With Other MCPs

ArnOS is focused on your personal OS core. Use it alongside other MCP servers:

• Readwise MCP - Access Reader documents & highlights, save as learnings
• Google Calendar MCP - Check schedule, reference in journal
• X MCP - Post tweets and threads from your learnings
• Notion, Todoist MCPs - Connect your existing tools

---

Why ArnOS?

vs. Just using Claude/ChatGPT:

• Your data persists in a structured database
• Context across all conversations (knows your entire life)
• Search and query your history
• Mobile access with quick actions
• Integrations with your tools

vs. Productivity apps:

• Conversational interface (natural language beats clicking)
• Everything connected (journal → learnings → todos → projects)
• AI-native (built for chat, not retrofitted)
• Self-hosted (your data, your infrastructure)

vs. Note-taking apps:

• Actionable (not just storage)
• Conversational querying
• Habit and CRM tracking built-in
• Content generation from your knowledge

---

Quick Start

Prerequisites

• PostgreSQL 14+
• Node.js 18+

Installation

# Clone the repository
git clone https://github.com/yourusername/arnos.git
cd arnos

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your database URL and credentials

# Set up database
# See DATABASE.md for schema

# Run locally
npm run dev

# Or build and deploy
npm run build
npm start

Configure Claude

Claude Code / Desktop: Add to your MCP config:

{
  "mcpServers": {
    "arnos": {
      "command": "node",
      "args": ["/path/to/arnos/dist/index.js"],
      "env": {
        "DATABASE_URL": "your-connection-string"
      }
    }
  }
}

• Claude Code: ~/.config/claude-code/.mcp.json
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

Mobile/Web: Deploy to a server and add as Custom Connector in Claude.ai settings.

See SETUP.md for detailed instructions.

---

Usage Examples

Process Reading

You: "Review my Readwise articles from this week about AI agents"
ArnOS: [Shows 4 articles]

You: "Extract key learnings"
ArnOS: [Saves 5 learnings to database]

You: "Create a project: Build simple AI agent"
ArnOS: [Creates project with initial todos]

Manage Your Day

You: "What's on my plate today?"
ArnOS: "3 todos due:
      - Fix login bug (DirectBook)
      - Call Sarah (CRM follow-up)
      - Journal entry

      2 habits to track:
      - Reading
      - Workout"

You: "Add todo: prep for design review tomorrow"
ArnOS: [Creates todo]

Track Relationships

You: "What's my relationship status with Sarah?"
ArnOS: "Sarah - CRM contact
       Last touch: Email Dec 1
       Open todo: Call about DirectBook proposal
       Deal stage: Negotiation ($15k)
       Next action: Follow up on pricing"

---

The Flow

Using ArnOS with Readwise MCP (example):

1. Save article to Readwise Reader
2. "Search my Readwise for articles about AI agents" (Readwise MCP)
3. "Extract key insights and save as learnings" (ArnOS)
4. "Create a project from my AI learnings" (ArnOS)
5. Project created with todos (ArnOS)
6. "Generate a thread from these learnings" (Claude + context)
7. "Post this thread" (X MCP)

Content → Knowledge → Action → Distribution

Multiple focused MCPs working together.

---

Architecture

• Runtime: Node.js 18+ / TypeScript
• Framework: Express.js
• Protocol: Model Context Protocol (MCP)
• Database: PostgreSQL 14+
• Auth: OAuth 2.1 with PKCE (for mobile/web)

---

Development

# Run in development mode
npm run dev

# Build
npm run build

# Run production build
npm start

---

Database

See DATABASE.md for:

• Complete schema
• Table descriptions
• Setup instructions
• Migration guide

---

Contributing

Contributions welcome! See CONTRIBUTING.md

---

Community

• Issues: Report bugs or request features
• Discussions: Share use cases, ask questions

---

License

MIT License - see LICENSE

---

Acknowledgments

Built on the Model Context Protocol by Anthropic.

Inspired by the need to actually use the knowledge we collect.