kriyan

The kriyan command

Everything you can see and change in Kriyan, from a terminal. Add --json to any command for output a script or an agent can read.

Install

The CLI runs on Bun. Until it is published as a package, run it from the source:

Terminal
git clone https://github.com/kausthubh-coder/kriyan
cd kriyan
bun install
bun run kriyan --help

Sign in

In Kriyan, open Settings and create a personal access token named after this computer. Then save it:

Terminal
kriyan login
# or
kriyan login --token kriyan_...

The token is checked before it is saved, and kept only on this computer. kriyan logout removes it; revoke it in Settings to stop it working everywhere.

Examples

Terminal
kriyan today
kriyan week
kriyan add "essay fri 5pm #school every week remind 1h before"
kriyan add "calculus lecture every tue and thu 10:00-11:30 #school"
kriyan done 2
kriyan move 3 5 tomorrow 9am
kriyan today --json

A task is the number shown next to it in your last listing, part of its title, or its id. add reads the same phrases as quick add in the app.

Commands

See your plan

today [date]Now and next, the schedule, anytime tasks, habits and free time
week [start]Seven days from Monday, or from the date you give
inboxTasks without a date or a space
spacesYour spaces as a tree
progressTime done, goals and habits

Change it

add <sentence>Add a task the way you'd say it
done <task>Tick a task off
move <task...> <when>Move tasks to another day or time
rm <task>Delete a task; restore it from the app
habit <name>Check a habit for today, or uncheck it with --undo
proposePropose time blocks from a file for you to accept in the app

Account and agents

loginSave a personal access token from Settings
logoutRemove the saved token
call <op> [json]Run any operation of the agent API
opsList the operations

kriyan <command> --help shows the options and examples for each command.

Environment

KRIYAN_TOKENUse this token instead of the saved one, for scripts and CI.
KRIYAN_API_URLTalk to another Kriyan server. The default is https://kriyan.app.
NO_COLORLeave out the coloured space dots.

Exit codes: 0 when it worked, 1 when Kriyan refused the change, 2 for a usage or network problem.