Skip to main content

Todo and Tasks

Elftia provides two task management tools to cover different needs from temporary notes to project-level management:

  • Todo Items — Lightweight personal todo list, quick capture across sessions
  • Task Management — Complete project-level board and list management

Both can be read and written by AI tools: Agents can directly update todo status after completing work, and instructions received through Channels can be recorded as todos with source tags.

Todo Items​

Access: Left navigation Todo (route /todo).

Core Features​

FeatureDescription
Quick AddType in the top input box and press Enter to create
Status ManagementClick checkbox to toggle completion; list automatically divides into "Pending" and "Completed"
ArchiveCompleted todos can be archived to "Archived" tab, archived items can be restored
PriorityUrgent / High / Medium (default) / Low — four levels
Source TrackingTodos created through Channels display source tags

Usage Steps​

  1. Go to the Todo items page
  2. Type todo content in the top input box
  3. Press Enter to add
  4. Click checkbox to mark complete
  5. Hover over items to see archive and delete buttons

Task Management​

Access: Usually switch to Tasks view at the top of the Todo page, or call task tools from Cowork / Agent.

Projects and Boards​

  • Support creating multiple projects, each with independent task lists
  • Manage projects in left sidebar, supports folder organization
  • Default project includes Todo / Doing / Done three status columns

Board View​

  • Tasks displayed as cards in status columns
  • Drag and drop cards between columns → change task status
  • Columns can be collapsed / expanded
  • Quick add new task at bottom of column
  • Support custom status columns (default Todo / Doing / Done cannot be deleted)
  • Archived tasks receive a default collapsed "Archived" column

List View​

  • Status-grouped list display
  • "Completed" group collapsed by default
  • Also supports search and priority filtering

Task Details​

Click a task card to open edit panel on the right:

FieldDescription
TitleTask name
DescriptionDetailed description (supports Markdown)
TagsMultiple tags, color-coded
PriorityNone / Low / Medium / High / Urgent
Due DateOptional

Content edits are auto-saved (400 ms debounce), no need to manually save.

Quick Create Syntax​

Task input box supports inline syntax, press Enter after typing to create directly:

SyntaxEffect
!high / !medium / !low / !urgentSet priority
#tagAdd tag
@nameSpecify creator
Date markers (e.g., tomorrow, 2026-05-12)Set due date

View Switching​

View buttons in the top toolbar switch between board view and list view.

AI and Todo Collaboration​

Todo and task systems are transparent and read-writable to AI:

  • Agents automatically update corresponding task status after completing sub-work
  • "Remind me..." instructions received through Channels are recorded as todos with source tags
  • Scheduled tasks (Cron) can write a todo or task after execution completes

This lets you treat AI as a "collaborator that updates the board itself", not just a chatbot that replies to messages.

FAQs​

QuestionAnswer
What's the difference between Todo and Task Management?Todo is suitable for simple personal checklists; Tasks provides complete project management (multiple projects, board view, custom status columns, drag-and-drop sorting).
Where is task data stored?Tasks are stored as files in the workspace directory, supporting multi-workspace isolation.
How do I add custom status columns?In board view, scroll to the far right and click +, enter column name and press Enter. Default Todo / Doing / Done cannot be deleted.
Where do source tags come from?Todos created through Channels (Discord / Telegram, etc.) automatically get source tags for easy traceability.