You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Your tasks are yours. They don't belong in someone else's cloud.
103
-
104
-
---
105
-
106
-
## ✨ What it can do
107
-
108
-
### Nested Tasks & Hierarchy
109
-
Organize your workspace into hierarchies.
110
-
111
-
-**Creating Nested Tasks**: When creating or editing a task, use the **Parent** field to specify the ID of the parent task. This instantly nests the task under the parent in your list view.
112
-
-**Collapsing/Expanding**:
113
-
- Parents with children are marked with an indicator (`▼` for expanded, `▶` for collapsed).
114
-
- Use **`Space`** on a parent task to toggle its expanded/collapsed state.
115
-
- When a parent is collapsed, all its children are hidden, keeping your view focused.
116
-
-**Hierarchy Visibility**: Tasks are automatically indented based on their nesting level, making it easy to visualize your project structure at a glance.
117
-
-**Export/Import Preservation**: All export formats (JSON, CSV, Markdown, Text) now fully preserve your task hierarchy. Markdown and Text exports use structured indentation that is automatically recognized during import, ensuring your project structure remains intact across any format.
73
+
## Features
118
74
119
-
### It's fast — genuinely fast
120
-
Sub-millisecond fuzzy search. Full keyboard control. Vim bindings (`j/k/gg/G`). Natural language deadlines like `tomorrow 10am` or `next friday`. You never have to leave the keyboard.
75
+
121
76
122
-
### Recurring tasks
123
-
Tasks can automatically reappear based on a schedule. Weekly (e.g. `mon,wed,fri`) or Monthly (e.g. `15`). When a recurring task is completed, Kairo automatically generates the next instance with a smart due date preview in the editor, ensuring you never miss a beat.
77
+
### ⚡ Genuinely Fast
78
+
Sub-millisecond fuzzy search. Vim bindings (`j/k/gg/G`). Natural language deadlines like `tomorrow 10am` or `next friday`. Full keyboard control — you never touch the mouse.
124
79
125
-
### It respects your data
126
-
SQLite storage with WAL mode. Fully offline. Optional Git-backed sync — no backend, no account, no lock-in. Export to JSON, CSV, Markdown, or plain text whenever you want.
80
+
### 🗂 Nested Tasks & Hierarchy
81
+
Organize work into deep hierarchies. Nest tasks via the **Parent** field in the editor, collapse/expand with `Space`, and export/import with full structure preserved — across JSON, CSV, Markdown, and plain text.
127
82
128
-
### It grows with you
129
-
A Lua plugin system lets you hook into task events. A headless CLI API means you can automate anything. And an MCP server opens Kairo up to AI agents that can read and manage your tasks directly — now with full support for recurring schedules and nested hierarchies.
83
+
### 🔁 Recurring Tasks
84
+
Tasks reappear automatically on a schedule. Weekly (`mon,wed,fri`) or monthly (`15`). When completed, Kairo generates the next instance immediately with a smart due-date preview.
130
85
131
-
### AI — when you want it, invisible when you don't
132
-
Optional Gemini integration (`gemini-3.1-flash-lite-preview` / `gemini-2.0-flash-lite` / `gemini-2.5-flash-lite`). Toggle it with `ctrl+a`. It never runs unless you invoke it. Now you can create and manage complex recurring tasks using simple natural language prompts. Your workflow, your call.
86
+
### 🔒 Your Data, Locally
87
+
SQLite with WAL mode. Fully offline. Optional Git-backed sync — no backend, no account, no lock-in. Export to JSON, CSV, Markdown, or plain text on demand.
133
88
134
-
### Beautiful by default
135
-
32 built-in themes. Live switching with `t`. Bento-style layout. Real-time Markdown preview (`ctrl+p`). Cinematic animations for create, complete, and delete.
89
+
### 🤖 AI — Optional, Never Intrusive
90
+
Gemini integration (`gemini-2.5-flash-lite` / `gemini-2.0-flash-lite`). Toggle with `ctrl+a`. Create and manage complex recurring tasks with natural language. Invisible until you need it.
136
91
137
-
Each theme features a complete color palette that fills your entire terminal window with a seamless, edge-to-edge background — no gaps, no terminal defaults bleeding through. Whether you're in fullscreen mode or a resized window, the themed background covers the entire viewport consistently. All colors are fully reset to your terminal's default when Kairo exits.
92
+
### 🎨 Beautiful by Default
93
+
32 built-in themes with edge-to-edge background coverage. Live switching with `t`. Bento-style layout. Real-time Markdown preview (`ctrl+p`). Cinematic create/complete/delete animations — or disable them entirely in `config.toml`.
138
94
139
-
**Note:** Animations can be fully disabled in `config.toml` (`animations = false`) or the Settings TUI.
95
+
### 🧩 Extensible to the Core
96
+
A Lua plugin system hooks into task events. A headless CLI API enables full scripting. An MCP server opens Kairo to AI agents — with complete support for recurring schedules and nested hierarchies.
140
97
141
98
---
142
99
143
-
## ⌨️ The shortcuts that matter
100
+
## Keyboard Shortcuts
144
101
145
-
| Key |What it does|
102
+
| Key |Action|
146
103
|---|---|
147
104
|`n`| New task |
148
-
|`Space`| Toggle collapse/expand |
149
-
|`e`| Edit |
150
-
|`z`| Complete |
151
-
|`d`| Delete |
152
-
|`t`| Switch theme |
105
+
|`e`| Edit task |
106
+
|`z`| Complete task |
107
+
|`d`| Delete task |
108
+
|`Space`| Collapse / expand subtasks |
153
109
|`f`| Filter by tag |
154
-
|`ctrl+p`| Command palette / Preview |
155
-
|`ctrl+a`| AI panel | Hidden if API key is missing |
0 commit comments