SkillAgentSearch skills...

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/pikos

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

81/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
4/20
Freshness
15/15

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 found

Our 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.

SkillScoreStarsUpdatedFormat
pikos (this skill)by Pikos-App81102d agoMCP Server
Agent-Reachby Panniantong10087.2k16d agoCLAUDE.md
headroomby headroomlabs-ai10074.2ktodayCLAUDE.md
rufloby ruvnet10073.6ktodayCLAUDE.md
CowAgentby zhayujie10047.2ktodayCLAUDE.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.
<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="apps/brand/svg/pikos-dark.svg"> <img src="apps/brand/svg/pikos-light.svg" alt="Pikos" width="128" height="128"> </picture> </p>

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.

Website · Download · Blog

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 .ics calendar of your scheduled pages, at any time. Your data is portable.
  • Command line and MCP — pikos reads and writes the same workspace file, and pikos mcp serves 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

View on GitHub
GitHub Stars10
CategoryDevelopment
Updated2d ago
Forks1

Languages

TypeScript

Trust signals

85/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 info