feat: implement nested task hierarchy with parent-child support, add Steel theme, and improve task editing UI

Author: programmersd21

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.2]
+### Added
+- **Nested Tasks & Hierarchy**: Support for parent/child task relationships, including collapsible parent tasks and task nesting UI.
+- **API Support**: Added `parent_id` and `collapsed` fields to the API and data model.
+- **New Theme**: Added "Steel" theme, featuring a professional deep-blue industrial aesthetic.
+
+### Fixed
+- **Animation Bug**: Tab animation now correctly respects the animation toggle setting when cancelling a quit operation.
+
 ## [1.4.1]
 
 ### Added

README.md

@@ -11,16 +11,19 @@ Fast. Local. Yours.
 <br/>
 
 [![Release](https://img.shields.io/github/v/release/programmersd21/kairo?style=for-the-badge&logo=github&color=7c3aed)](https://github.com/programmersd21/kairo/releases)
-[![CI](https://img.shields.io/github/actions/workflow/status/programmersd21/kairo/ci.yml?branch=main&style=for-the-badge&logo=githubactions&color=2563eb)](https://github.com/programmersd21/kairo/actions)
+[![CI](https://img.shields.io/github/actions/workflow/status/programmersd21/kairo/ci.yml?branch=main&style=for-the-badge&logo=github&color=2563eb)](https://github.com/programmersd21/kairo/actions)
 [![Go Report Card](https://img.shields.io/badge/go%20report-A%2B-brightgreen?style=for-the-badge&logo=go&logoColor=white)](https://goreportcard.com/report/github.com/programmersd21/kairo)
 [![License: MIT](https://img.shields.io/badge/License-MIT-f59e0b?style=for-the-badge)](https://opensource.org/licenses/MIT)
 
 </div>
 
+![Home Screen](screenshots/home_screen.png)
+
 ---
 
 You know that feeling when your task manager gets in the way of your actual work?
 
+
 Kairo was built because of that feeling.
 
 No browser tabs. No subscriptions. No mouse. Just you, your terminal, and your tasks — right where your brain already lives.
@@ -83,12 +86,24 @@ Most tools ask you to adapt to them. Kairo adapts to you.
 | Plain-text tools lack structure | Full tagging, filtering, and fuzzy search |
 | Legacy TUIs feel clunky | Modern, animated, keyboard-first UX |
 
+![Filter Tags](screenshots/filter_tags.png)
+
 Your tasks are yours. They don't belong in someone else's cloud.
 
 ---
 
 ## ✨ What it can do
 
+### Nested Tasks & Hierarchy
+Organize your workspace into hierarchies. 
+
+- **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.
+- **Collapsing/Expanding**: 
+    - Parents with children are marked with an indicator (`▼` for expanded, `▶` for collapsed).
+    - Use **`Space`** on a parent task to toggle its expanded/collapsed state.
+    - When a parent is collapsed, all its children are hidden, keeping your view focused.
+- **Hierarchy Visibility**: Tasks are automatically indented based on their nesting level, making it easy to visualize your project structure at a glance.
+
 ### It's fast — genuinely fast
 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.
 
@@ -99,13 +114,17 @@ Tasks can automatically reappear based on a schedule. Weekly (e.g. `mon,wed,fri`
 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.
 
 ### It grows with you
-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.
+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.
 
 ### AI — when you want it, invisible when you don't
 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.
 
 ### Beautiful by default
-32 built-in themes. Live switching with `t`. Bento-style layout. Real-time Markdown preview (`ctrl+p`). Cinematic animations for create, complete, and delete (with a global toggle in `ctrl+s` to disable them for maximum speed). It's a terminal app that you'll actually enjoy looking at.
+32 built-in themes. Live switching with `t`. Bento-style layout. Real-time Markdown preview (`ctrl+p`). Cinematic animations for create, complete, and delete. 
+
+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.
+
+**Note:** Animations can be fully disabled in `config.toml` (`animations = false`) or the Settings TUI.
 
 ---
 
@@ -114,6 +133,7 @@ Optional Gemini integration (`gemini-3.1-flash-lite-preview` / `gemini-2.0-flash
 | Key | What it does |
 |---|---|
 | `n` | New task |
+| `Space` | Toggle collapse/expand |
 | `e` | Edit |
 | `z` | Complete |
 | `d` | Delete |
@@ -126,11 +146,17 @@ Optional Gemini integration (`gemini-3.1-flash-lite-preview` / `gemini-2.0-flash
 | `x` | Import/Export | |
 | `ctrl+d` | Welcome tour | |
 
+<div style="display: flex; gap: 10px;">
+  <img src="screenshots/help_menu.png" width="30%" />
+  <img src="screenshots/settings_menu.png" width="30%" />
+  <img src="screenshots/theme_menu.png" width="30%" />
+</div>
+
 ---
 
 ## 🚀 Automate everything
 
-Kairo has a full CLI API for scripting and pipelines:
+Kairo has a full CLI API for scripting and pipelines. It fully supports `parent_id` and `collapsed` state for automation:
 
 ```bash
 # Create a task from anywhere
@@ -144,18 +170,6 @@ kairo api update --id <id> --status done
 
 # Export your whole list
 kairo export --format markdown
-
-# Sync via Git
-kairo sync
-
-# Start the MCP server (for AI agents)
-kairo mcp        # stdio mode
-kairo mcp 8080   # SSE mode
-```
-
-JSON mode for maximum scriptability:
-```bash
-kairo api --json '{"action":"create","payload":{"title":"API task"}}'
 ```
 
 ---
@@ -176,10 +190,6 @@ end)
 return plugin
 ```
 
-Available hooks: `task_create` · `task_update` · `task_delete` · `app_start` · `app_stop`
-
-Available API: `create_task`, `update_task`, `delete_task`, `list_tasks`, `on`, `notify`
-
 **Find sample plugins [here](https://github.com/programmersd21/kairo/tree/main/plugins).**
 
 ---
@@ -205,6 +215,7 @@ Your input (CLI / TUI / Lua / AI)
 | Feature | Status |
 |---|---|
 | Local-first SQLite storage | ✅ |
+| Folders & Nested Tasks | ✅ |
 | Full TUI with 32 themes | ✅ |
 | Keyboard-only workflow | ✅ |
 | Git sync (no backend) | ✅ |

VERSION.txt

@@ -1 +1 @@
-1.4.1
+1.4.2

internal/api/api.go

@@ -107,6 +107,8 @@ type TaskDTO struct {
 	Recurrence        string   `json:"recurrence,omitempty"`
 	RecurrenceWeekly  []string `json:"recurrence_weekly,omitempty"`
 	RecurrenceMonthly int      `json:"recurrence_monthly,omitempty"`
+	ParentID          string   `json:"parent_id,omitempty"`
+	Collapsed         bool     `json:"collapsed,omitempty"`
 	CreatedAt         string   `json:"created_at"`
 	UpdatedAt         string   `json:"updated_at"`
 }
@@ -123,6 +125,8 @@ func toDTO(t core.Task) TaskDTO {
 		Recurrence:        string(t.Recurrence),
 		RecurrenceWeekly:  t.RecurrenceWeekly,
 		RecurrenceMonthly: t.RecurrenceMonthly,
+		ParentID:          t.ParentID,
+		Collapsed:         t.Collapsed,
 		CreatedAt:         t.CreatedAt.Format("2006-01-02T15:04:05Z"),
 		UpdatedAt:         t.UpdatedAt.Format("2006-01-02T15:04:05Z"),
 	}
@@ -145,6 +149,8 @@ func (api *TaskAPI) handleCreate(ctx context.Context, payload json.RawMessage) R
 		Recurrence        string   `json:"recurrence,omitempty"`
 		RecurrenceWeekly  []string `json:"recurrence_weekly,omitempty"`
 		RecurrenceMonthly *int     `json:"recurrence_monthly,omitempty"`
+		ParentID          string   `json:"parent_id,omitempty"`
+		Collapsed         bool     `json:"collapsed,omitempty"`
 	}
 
 	var p CreatePayload
@@ -170,6 +176,8 @@ func (api *TaskAPI) handleCreate(ctx context.Context, payload json.RawMessage) R
 		Recurrence:        core.RecurrenceType(p.Recurrence),
 		RecurrenceWeekly:  p.RecurrenceWeekly,
 		RecurrenceMonthly: 0,
+		ParentID:          p.ParentID,
+		Collapsed:         p.Collapsed,
 	}
 
 	if p.RecurrenceMonthly != nil {
@@ -251,6 +259,8 @@ func (api *TaskAPI) handleUpdate(ctx context.Context, payload json.RawMessage) R
 		Recurrence        *string  `json:"recurrence,omitempty"`
 		RecurrenceWeekly  []string `json:"recurrence_weekly,omitempty"`
 		RecurrenceMonthly *int     `json:"recurrence_monthly,omitempty"`
+		ParentID          *string  `json:"parent_id,omitempty"`
+		Collapsed         *bool    `json:"collapsed,omitempty"`
 	}
 
 	var p UpdatePayload
@@ -271,6 +281,8 @@ func (api *TaskAPI) handleUpdate(ctx context.Context, payload json.RawMessage) R
 	patch := core.TaskPatch{
 		Title:       p.Title,
 		Description: p.Description,
+		ParentID:    p.ParentID,
+		Collapsed:   p.Collapsed,
 	}
 
 	if p.Recurrence != nil {