pikos
Health Warn
- License — License: NOASSERTION
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 9 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Notes, tasks, and calendar. One app, on your computer. Tauri + React + SQLite, with an MCP server for the assistant you already use.
Pikos
Notes, tasks, and calendar. One app, on your computer.
Pikos is a desktop app for macOS and Linux where a note, a task, and a calendar event are the same page. No account, no subscription, and no Pikos server. Your data is a SQLite file on your machine.
AI never gets in your way: Pikos opens to your page, not a chat box. If you want AI help, an MCP server ships with it, so the assistant you already use can search, read, and write your notes. Pikos itself sends nothing anywhere; a cloud assistant sends what it reads to its provider, and a local model keeps everything on your machine.
Features
- Rich text editor — Headings, bold, italic, checklists, code blocks, blockquotes. Slash commands, format toolbar, Markdown paste support.
- Task management — Status tracking, four-level priority, tags, smart views (Today, Inbox), drag-and-drop reordering.
- Built-in calendar — One to seven days, or a month, alongside the editor. Drag pages to schedule them. Click a time slot to create a page.
- Calendar sync — Read-only, opt-in sync from iCloud, Google Calendar, or any CalDAV server. Your events arrive as pages you can take notes on. Nothing you write is sent back, and credentials go to the OS keychain.
- Full-text search — FTS5-powered search across all page content. Ranked results with previews.
- Quick capture — Natural language input: "Call dentist tomorrow high priority #health" creates a page with title, date, priority, and tag set automatically.
- Keyboard-first — Every action has a shortcut. Navigate, create, schedule, and search without reaching for the mouse.
- Private by default — Everything stored locally in SQLite. No accounts, no telemetry. Two network requests, both visible: an update check at launch, which you can turn off, and calendar sync once you connect a calendar. Updates are never installed without your approval.
- Export — SQLite backup, Markdown folder, CSV, or an
.icscalendar of your scheduled pages, at any time. Your data is portable. - Command line and MCP —
pikosreads and writes the same workspace file, andpikos mcpserves it to an AI agent over the Model Context Protocol. Local, no account, no listening socket.
Command line and MCP server
brew install pikos-app/tap/pikos-cli puts pikos on your PATH. It opens the same
workspace file the desktop app uses, so pikos today, pikos add "Email Sam tomorrow 2pm #work", and pikos search work against your real notes.
pikos mcp speaks the Model Context Protocol over stdio,
which lets an agent search, read, create, and update your pages. It opens no network socket,
so nothing reaches your notes except the assistant that started it. Point a client at it:
{ "mcpServers": { "pikos": { "command": "pikos", "args": ["mcp"] } } }
Every tool is a thin wrapper over the same code the subcommands use. Deleting only
moves a page to the trash and restoring undoes it, so nothing an agent does is one-way, and
the server refuses to migrate your workspace behind your back. Full reference:crates/pikos-cli/README.md and
pikos.app/cli.
Stack
| Layer | Technology |
|---|---|
| Desktop shell | Tauri 2 (Rust) |
| Frontend | React 19 + TypeScript (strict) |
| Editor | Tiptap (ProseMirror) |
| Database | SQLite with FTS5 |
| UI | shadcn/ui + Tailwind CSS v4 |
| Build | Vite + Turborepo |
| Package manager | pnpm |
Repository structure
pikos/
apps/
desktop/ — Tauri app (Rust backend + React frontend)
marketing/ — pikos.app website (Astro + Tailwind)
brand/ — logos and brand assets
mobile/ — iPhone app (placeholder, not started)
packages/
core/ — shared TypeScript library (types, utils, Quick Add parser, storage interface)
pikos-bridge/ — Quick Add parser exposed to the Rust CLI as a node subprocess
recurrence-wasm/— the Rust recurrence engine compiled to WebAssembly for the JS apps
ui/ — shared UI components
crates/
pikos-db/ — local SQLite data layer (schema, migrations, writer) shared by desktop and CLI
pikos-cli/ — command-line interface, headless access to the local workspace
pikos-calendar-sync/ — read-only CalDAV and Google Calendar sync into the local workspace
pikos-recurrence/ — recurrence (RRULE) engine, single-sourced for native + wasm consumers
pikos-recurrence-wasm/ — wasm-bindgen bindings that build packages/recurrence-wasm
Development
Prerequisites: Node.js (v20+), pnpm (v10+), Rust, and the Tauri 2 system dependencies for your platform.
git clone https://github.com/pikos-app/pikos.git
cd pikos
pnpm install
pnpm dev:desktop
Commands
| Command | What it does |
|---|---|
pnpm dev:desktop |
Start the Tauri desktop app in dev mode |
pnpm dev:marketing |
Start the marketing site dev server |
pnpm verify |
Run typecheck, lint, prettier, dependency cruiser, and tests |
pnpm test |
Run unit tests (Vitest) |
pnpm build |
Build all packages |
Data
All data is stored in a local SQLite database. The schema is defined across migration files in crates/pikos-db/migrations/. Every page is simultaneously a rich-text document, a trackable task, and a calendar event: one pages table with structured metadata columns alongside ProseMirror JSON content.
The database location follows your OS conventions:
- macOS:
~/Library/Application Support/app.pikos.desktop/ - Linux:
~/.local/share/app.pikos.desktop/
You can open the database with any SQLite client and query your own data directly.
License
Pikos is source-available under the Business Source License 1.1. You can read, audit, and build the code for personal use. Commercial redistribution is not permitted. The license converts to Apache 2.0 after four years.
See the blog for more on the licensing philosophy.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found