Kriyan
A calm planner for time boxing. Put everything you have to do in one place, give it a time on your day, and keep the plan quiet enough to follow. The AI you already use (Claude, ChatGPT, Cursor and others) can plan with you.
Open the web app · Get it on Android · Docs
What it does
- Today: what's next, a timeline you drag tasks onto, anytime tasks and the free time left.
- Tasks in one sentence:
calculus lecture every tue and thu 9am for 1h30 #school/calculus or mum's birthday 16 oct every year remind day before at 20:00.
- Repeats: chosen weekdays at a time and length, first or last day of the month, the nth weekday, yearly, every N days after done, until a date or N times.
- Reminders: as many as you like per task, on Android.
- Spaces inside spaces, each with Markdown notes.
- Goals, habits and a year-long activity heatmap.
- Your AI: an MCP server at
https://kriyan.app/mcp, an HTTP API and a kriyan CLI. Agents can propose a plan that you accept or discard.
Use it
- Web: app.kriyan.app.
- Android: download kriyan.apk from the latest release (Android 7 or newer).
- AI assistants: add
https://kriyan.app/mcp as a connector, or use a personal access token from Settings. Setup guide.
- Terminal:
bun run kriyan login, then bun run kriyan today from a checkout of this repo. CLI guide.
Develop
Bun workspaces: an Expo app (Android and the web app), a Next.js site (landing, docs, MCP), a Convex backend and Clerk for sign-in.
| Where | What |
|---|
packages/core | Shared logic: dates, repeats, reminders, the quick-add parser, design tokens, the agent operations |
packages/convex | The backend |
apps/app | Expo Router app for Android and the web |
apps/site | kriyan.app: landing, docs, /mcp |
packages/cli | The kriyan command |
bun install
bun run dev # backend, web app and site
bun run check # format, types, lint, tests
You need your own Convex project and Clerk application; put their values in .env.local files (bun run doctor lists what's missing). AGENTS.md is the guide for working in the repo, for people and coding agents alike.
License
MIT
