# Vision — Joanium

## What We're Building

Joanium is a **local-first AI desktop assistant** that puts users fully in control
of their AI experience — with no cloud lock-in, no subscriptions to a single provider,
and no data leaving the machine unless the user explicitly chooses it.

The goal is a single, powerful desktop application where users can:

- Chat with any AI model (Anthropic, OpenAI, Gemini, Ollama, and more)
- Build and schedule autonomous agents that run tasks on their behalf
- Connect tools and services via MCP (Model Context Protocol)
- Create custom personas, skills, and system instructions
- Automate workflows across Gmail, GitHub, and other real integrations
- Do all of this privately, offline-capable, and without a middleman

---

## Core Principles

**Local-first.** User data lives on the user's machine. No telemetry, no sync unless opt-in.

**Provider-agnostic.** No single AI vendor should be a dependency. Swap models freely.

**Composable.** Capabilities, features, skills, and personas are modular and independently extensible.

**Desktop-grade UX.** This is a native desktop app, not a web app wrapped in a frame. Performance and feel should match native expectations.

**Developer-friendly.** The codebase should be readable, well-structured vanilla JavaScript — approachable without a heavy build toolchain.

---

## What Success Looks Like

- A power user can automate their daily workflow end-to-end without touching a cloud AI dashboard.
- A developer can add a new model provider or capability module in under an hour.
- An agent can be scheduled, run autonomously, and report results — all locally.
- The app ships cross-platform binaries that install and run without a server or internet connection.

---

## Out of Scope

- A hosted/SaaS version of Joanium (the desktop app is the product)
- Replacing general-purpose coding tools (IDE plugins, GitHub Copilot, etc.)
- Social or collaborative features — this is a personal assistant, not a team tool
