feat: implement recurring task support with weekly and monthly scheduling logic, and fix rendering issues

- fixes #17
- completes #19

Author: programmersd21

CHANGELOG.md

@@ -5,6 +5,23 @@ 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.0]
+- **Recurring Tasks**: Introduced a robust, minimal system for tasks that automatically reappear.
+  - Supports Weekly recurrence (e.g. `mon,wed,fri`).
+  - Supports Monthly recurrence (e.g. `15`).
+  - Automatically generates the next instance when a recurring task is marked as done.
+  - Smart due date computation with missed cycle protection.
+  - Integrated into the task editor TUI for seamless workflow.
+- **Enhanced Recurrence Previews**: Added real-time "Next Occurrence" date previews to the task editor, providing instant feedback as you type recurrence rules.
+- **AI & MCP Recurrence Support**: Extended the Gemini-powered assistant and MCP server to support managing recurring tasks via natural language and external AI agents.
+- **Backward Compatibility**: Ensured that existing tasks and older database records default safely to `none` recurrence, preventing validation errors.
+- **Task ID Visibility**: Added a new setting to toggle the visibility of task IDs in the detail view.
+  - Configurable via `config.toml` (`show_id = true/false`) or the Settings TUI.
+  - Useful for users who prefer a cleaner interface without technical metadata.
+
+### Fixed
+- **Background Bleed**: Background not fully filling terminal viewport when using colored themes.
+
 ## [1.3.5]
 - **CLI Validation**: Added robust validation for subcommands and flags. Kairo now warns the user and provides helpful guidance when an invalid command or flag is provided.
 - **Global Flags**: Added support for `-h`/`--help` and `-v`/`--version` as global flags.

README.md

@@ -92,14 +92,17 @@ Your tasks are yours. They don't belong in someone else's cloud.
 ### 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.
 
+### Recurring tasks
+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.
+
 ### It respects your data
 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.
+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.
 
 ### 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. Your workflow, your call.
+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.
@@ -220,6 +223,15 @@ Auto-generated on first run:
 - **macOS:** `~/Library/Application Support/kairo/config.toml`
 - **Windows:** `%APPDATA%\kairo\config.toml`
 
+| Option | Description | Default |
+|---|---|---|
+| `theme` | UI theme name | `catppuccin` |
+| `vim_mode` | Enable Vim keybindings | `false` |
+| `show_help` | Show help footer | `true` |
+| `show_id` | Show task IDs in detail view | `true` |
+| `animations` | Enable UI animations | `true` |
+| `rainbow` | Animated rainbow logo | `false` |
+
 Prefer in-app settings? `ctrl+s` opens the settings menu.
 
 ---

VERSION.txt

@@ -1 +1 @@
-1.3.5
+1.4.0

configs/kairo.example.toml

@@ -2,6 +2,7 @@
 theme = "catppuccin"
 vim_mode = false
 show_help = true
+show_id = true
 rainbow = false
 animations = true
 mcp_enabled = false

internal/ai/gemini.go

@@ -67,6 +67,7 @@ Context Data: %s
 You have TOTAL control over the user's tasks, projects, UI themes, and Lua plugins through tool calls. 
 You can:
 - Manage tasks (create, update, delete, list, tags, priority, status, deadline).
+- Recurring tasks: use 'recurrence' (none|weekly|monthly), 'recurrence_weekly' (e.g. ["mon", "wed"]), 'recurrence_monthly' (e.g. 15).
 - Change the UI theme (e.g. catppuccin, dracula, nord, midnight, etc.) using 'set_theme'.
 - Manage Lua plugins (list, read, write, delete) using 'plugin_*' actions.
 - Configure AI settings and export data.

internal/ai/tools.go

@@ -31,7 +31,7 @@ func GetKairoTools() *genai.Tool {
 						},
 						"payload": {
 							Type:        genai.TypeObject,
-							Description: "JSON payload for the action. For 'set_theme', use 'theme' (string). For 'plugin_list', use {}. For 'plugin_get/delete', use 'name' (string). For 'plugin_write', use 'name' and 'content' (string). Tasks use title, description, tags, priority, status, deadline.",
+							Description: "JSON payload for the action. For 'set_theme', use 'theme' (string). For 'plugin_list', use {}. For 'plugin_get/delete', use 'name' (string). For 'plugin_write', use 'name' and 'content' (string). Tasks use title, description, tags, priority, status, deadline, recurrence (none|weekly|monthly), recurrence_weekly (array of strings), recurrence_monthly (number).",
 						},
 					},
 					Required: []string{"action", "payload"},

internal/api/api.go

@@ -97,28 +97,34 @@ func (api *TaskAPI) cleanup(ctx context.Context) Response {
 
 // TaskDTO is the data transfer object for tasks (matches Lua and JSON schema)
 type TaskDTO struct {
-	ID          string   `json:"id"`
-	Title       string   `json:"title"`
-	Description string   `json:"description,omitempty"`
-	Tags        []string `json:"tags,omitempty"`
-	Priority    int      `json:"priority"`
-	Status      string   `json:"status"`
-	Deadline    *string  `json:"deadline,omitempty"`
-	CreatedAt   string   `json:"created_at"`
-	UpdatedAt   string   `json:"updated_at"`
+	ID                string   `json:"id"`
+	Title             string   `json:"title"`
+	Description       string   `json:"description,omitempty"`
+	Tags              []string `json:"tags,omitempty"`
+	Priority          int      `json:"priority"`
+	Status            string   `json:"status"`
+	Deadline          *string  `json:"deadline,omitempty"`
+	Recurrence        string   `json:"recurrence,omitempty"`
+	RecurrenceWeekly  []string `json:"recurrence_weekly,omitempty"`
+	RecurrenceMonthly int      `json:"recurrence_monthly,omitempty"`
+	CreatedAt         string   `json:"created_at"`
+	UpdatedAt         string   `json:"updated_at"`
 }
 
 // toDTO converts a core.Task to a DTO for serialization
 func toDTO(t core.Task) TaskDTO {
 	dto := TaskDTO{
-		ID:          t.ID,
-		Title:       t.Title,
-		Description: t.Description,
-		Tags:        t.Tags,
-		Priority:    int(t.Priority),
-		Status:      string(t.Status),
-		CreatedAt:   t.CreatedAt.Format("2006-01-02T15:04:05Z"),
-		UpdatedAt:   t.UpdatedAt.Format("2006-01-02T15:04:05Z"),
+		ID:                t.ID,
+		Title:             t.Title,
+		Description:       t.Description,
+		Tags:              t.Tags,
+		Priority:          int(t.Priority),
+		Status:            string(t.Status),
+		Recurrence:        string(t.Recurrence),
+		RecurrenceWeekly:  t.RecurrenceWeekly,
+		RecurrenceMonthly: t.RecurrenceMonthly,
+		CreatedAt:         t.CreatedAt.Format("2006-01-02T15:04:05Z"),
+		UpdatedAt:         t.UpdatedAt.Format("2006-01-02T15:04:05Z"),
 	}
 	if t.Deadline != nil {
 		s := t.Deadline.Format("2006-01-02T15:04:05Z")
@@ -130,12 +136,15 @@ func toDTO(t core.Task) TaskDTO {
 // handleCreate processes a create request
 func (api *TaskAPI) handleCreate(ctx context.Context, payload json.RawMessage) Response {
 	type CreatePayload struct {
-		Title       string   `json:"title"`
-		Description string   `json:"description,omitempty"`
-		Tags        []string `json:"tags,omitempty"`
-		Priority    *int     `json:"priority,omitempty"`
-		Status      string   `json:"status,omitempty"`
-		Deadline    *string  `json:"deadline,omitempty"`
+		Title             string   `json:"title"`
+		Description       string   `json:"description,omitempty"`
+		Tags              []string `json:"tags,omitempty"`
+		Priority          *int     `json:"priority,omitempty"`
+		Status            string   `json:"status,omitempty"`
+		Deadline          *string  `json:"deadline,omitempty"`
+		Recurrence        string   `json:"recurrence,omitempty"`
+		RecurrenceWeekly  []string `json:"recurrence_weekly,omitempty"`
+		RecurrenceMonthly *int     `json:"recurrence_monthly,omitempty"`
 	}
 
 	var p CreatePayload
@@ -154,10 +163,17 @@ func (api *TaskAPI) handleCreate(ctx context.Context, payload json.RawMessage) R
 	}
 
 	task := core.Task{
-		Title:       p.Title,
-		Description: p.Description,
-		Tags:        p.Tags,
-		Status:      core.StatusTodo,
+		Title:             p.Title,
+		Description:       p.Description,
+		Tags:              p.Tags,
+		Status:            core.StatusTodo,
+		Recurrence:        core.RecurrenceType(p.Recurrence),
+		RecurrenceWeekly:  p.RecurrenceWeekly,
+		RecurrenceMonthly: 0,
+	}
+
+	if p.RecurrenceMonthly != nil {
+		task.RecurrenceMonthly = *p.RecurrenceMonthly
 	}
 
 	if p.Status != "" {
@@ -225,13 +241,16 @@ func (api *TaskAPI) handleGet(ctx context.Context, payload json.RawMessage) Resp
 // handleUpdate processes an update request
 func (api *TaskAPI) handleUpdate(ctx context.Context, payload json.RawMessage) Response {
 	type UpdatePayload struct {
-		ID          string   `json:"id"`
-		Title       *string  `json:"title,omitempty"`
-		Description *string  `json:"description,omitempty"`
-		Tags        []string `json:"tags,omitempty"`
-		Priority    *int     `json:"priority,omitempty"`
-		Status      *string  `json:"status,omitempty"`
-		Deadline    *string  `json:"deadline,omitempty"`
+		ID                string   `json:"id"`
+		Title             *string  `json:"title,omitempty"`
+		Description       *string  `json:"description,omitempty"`
+		Tags              []string `json:"tags,omitempty"`
+		Priority          *int     `json:"priority,omitempty"`
+		Status            *string  `json:"status,omitempty"`
+		Deadline          *string  `json:"deadline,omitempty"`
+		Recurrence        *string  `json:"recurrence,omitempty"`
+		RecurrenceWeekly  []string `json:"recurrence_weekly,omitempty"`
+		RecurrenceMonthly *int     `json:"recurrence_monthly,omitempty"`
 	}
 
 	var p UpdatePayload
@@ -254,6 +273,17 @@ func (api *TaskAPI) handleUpdate(ctx context.Context, payload json.RawMessage) R
 		Description: p.Description,
 	}
 
+	if p.Recurrence != nil {
+		r := core.RecurrenceType(*p.Recurrence)
+		patch.Recurrence = &r
+	}
+	if len(p.RecurrenceWeekly) > 0 {
+		patch.RecurrenceWeekly = &p.RecurrenceWeekly
+	}
+	if p.RecurrenceMonthly != nil {
+		patch.RecurrenceMonthly = p.RecurrenceMonthly
+	}
+
 	if len(p.Tags) > 0 {
 		patch.Tags = &p.Tags
 	}

internal/app/model.go

@@ -710,7 +710,10 @@ func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		cmds = append(cmds, cmd, m.listenAICmd())
 
 		if x.Chunk.Refresh {
-			cmds = append(cmds, m.loadTagsCmd(), m.loadTasksCmd(), m.loadAllTasksCmd(), m.syncIfEnabledCmd())
+			m.statusText = "AI updated database"
+			m.isErr = false
+			m.statusID++
+			cmds = append(cmds, m.loadTagsCmd(), m.loadTasksCmd(), m.loadAllTasksCmd(), m.syncIfEnabledCmd(), m.clearStatusCmd(m.statusID))
 		}
 		return m, tea.Batch(cmds...)
 
@@ -1351,6 +1354,7 @@ func (m *Model) renderMainUI() string {
 
 	// Update sizes dynamically — use mainW so components don't overflow
 	m.list.SetSize(mainW, availableHeight)
+	m.det.ShowID = m.cfg.App.ShowID
 	m.det.SetSize(mainW, availableHeight)
 	m.pal.SetSize(mainW, availableHeight)
 	m.pm.SetSize(mainW, availableHeight)

internal/config/config.go

@@ -25,6 +25,7 @@ type AppConfig struct {
 	Theme        string `toml:"theme"`
 	VimMode      bool   `toml:"vim_mode"`
 	ShowHelp     bool   `toml:"show_help"`
+	ShowID       bool   `toml:"show_id"`
 	Rainbow      bool   `toml:"rainbow"`
 	GeminiAPIKey string `toml:"gemini_api_key"`
 	AIModel      string `toml:"ai_model"`
@@ -98,6 +99,7 @@ func Default() Config {
 			Theme:      "catppuccin",
 			VimMode:    false,
 			ShowHelp:   true,
+			ShowID:     true,
 			Rainbow:    false,
 			AIModel:    "gemini-3.1-flash-lite-preview",
 			MCPEnabled: false,