pikos
Notes, tasks, and calendar. One app, on your computer. Local-first with no account, syncs your real calendar read-only, and ships an MCP server for the assistant you already use.
Install / Use
claude mcp add Pikos-App -- npx -y github:Pikos-App/pikosIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of pikos
pikos scores 81/100 on our quality scale, 2859th of 4,529 Development & Engineering skills we index.
Its MCP Server is 6.5 KB long, well organised into 9 sections with 3 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 2 days ago, so pikos is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 85/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
pikos compared with similar skills
All 4 of these similar skills score higher than pikos; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| pikos (this skill)by Pikos-App | 81 | 10 | 2d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 87.2k | 16d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 74.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 73.6k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 47.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install pikos?
- Run
claude mcp add Pikos-App -- npx -y github:Pikos-App/pikos. The install tabs above show the steps for each supported agent. - Which AI agents does pikos work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is pikos safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 85/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is pikos still maintained?
- The repository was last updated 2 days ago, so pikos is actively maintained.
Skill content
View source on GitHubPikos
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.
Related Skills
Agent-Reach
87.2kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
74.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ruflo
73.6k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
CowAgent
47.2kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
