# Hule documentation

> Tutorials, guides, concepts, recipes and reference

Start on your own or with a team, or go straight to the job you need to do.

## Table of Contents

### Get started

- [Start with Hule on your own](/get-started/solo.md): Set up a personal GTD system in Hule: an Inbox list, lists to sort into, a GTD session that empties the Inbox list, and a Today view as your home page.
- [Start Hule with your team](/get-started/team.md): Set up a workspace for a small team: a folder for your project, a team list, members, sharing and a first assigned task.

### Concepts

- [The Hule model](/concepts/hule-model.md): How Hule is put together: workspaces hold folders, folders hold lists, lists hold tasks — and views, sharing, statuses and relations work on top of that tree.
- [Folders inside folders](/concepts/hierarchy.md): Why Hule lets folders nest without limit (subfolders), and how to shape the tree around the way you already think about your work.
- [Views as lenses on tasks](/concepts/views.md): How a view shows the same tasks in one of eleven shapes — List, Kanban, Table, Timeline, Calendar, Dashboard and more — without copying them, and where each view may draw its tasks from.
- [Sharing along the hierarchy](/concepts/sharing.md): How access flows down the folder tree, and what someone sees when you share a folder, a list or a view with them.
- [Statuses and status templates](/concepts/statuses.md): How a list gets its statuses from a template, and why every status sits in one of three stages: Not started, Active or Done.
- [Task relations and the relations graph](/concepts/relations.md): What task relations are (blocks, relates to, duplicates, mentions), how # mentions create them, and how the Relations view draws them as a graph.
- [GTD in Hule](/concepts/gtd.md): The five steps of Getting Things Done and the Hule feature that carries each one.
- [Automations](/concepts/automations.md): How a trigger, conditions and actions let Hule do the routine part of your process for you.
- [Personal and work tasks in one place](/concepts/personal-and-work.md): How personal views and search show your tasks from every workspace together, so you see your whole day without switching workspaces.
- [Hule and AI](/concepts/ai-and-mcp.md): How an AI agent such as Claude reads and changes your tasks through MCP, and what it can and cannot do.

### Capture

- [Capture tasks to your Inbox list](/guides/capture-to-inbox.md): Get every new task into your Inbox list in a few seconds: from the app, Telegram, Claude or Raycast.
- [Add tasks from Telegram](/guides/add-tasks-from-telegram.md): Send /new to the Hule bot and get a task in the list you pick, without opening the app.
- [Connect an AI agent](/guides/connect-an-ai-agent.md): Connect Claude or another MCP client to Hule so it can read and change your tasks with your own access.

### Clarify

- [Run a GTD session](/guides/run-a-gtd-session.md): Go through your Inbox list one task at a time and decide what each task is and where it goes.

### Organize

- [Organize folders and lists](/guides/organize-folders-and-lists.md): Create folders and lists, nest them, reorder them and give them icons and colors.
- [Create and edit tasks](/guides/create-and-edit-tasks.md): Add a task, fill in its fields, change it from its row with quick actions, and duplicate, move or delete it from the task menu.
- [Write a task description](/guides/write-a-task-description.md): Format a task's description: headings, checklists, tables, images, and @-mentions of people and #-mentions of tasks.
- [Break a task down with subtasks](/guides/break-down-with-subtasks.md): Split a large task into subtasks and follow its progress.
- [Set up a recurring task](/guides/set-up-recurring-tasks.md): Make a task repeat on a fixed schedule or after you complete it, and pause, skip or stop the series.
- [Tag tasks](/guides/tag-tasks.md): Create colored tags, add them to tasks, share them between lists with a Tag Set and filter by them.
- [Link related tasks](/guides/link-related-tasks.md): Link tasks as dependencies (blocks / is blocked by) or as related work, and see the relations on a graph.
- [Set up a list](/guides/set-up-a-list.md): Choose a list's statuses, Task ID pattern and the built-in features its tasks show.
- [Edit tasks in bulk](/guides/edit-tasks-in-bulk.md): Select several tasks and change their status, dates, assignee or tags at once.

### Plan

- [Plan on the timeline and the calendar](/guides/plan-on-timeline-and-calendar.md): Give tasks start and due dates and arrange them on a timeline or a calendar.

### Focus

- [Build your own Today view](/guides/build-a-today-view.md): Make a personal view that gathers today's tasks from your workspaces, and open it as your home page.
- [Track time on a task](/guides/track-time.md): Start a timer, log time after the fact and compare it with the estimate.

### Review

- [Filter, sort and group a view](/guides/filter-sort-and-group-a-view.md): Show only the tasks you need, in the order and groups you want — worked through on one weekly view.
- [Build a dashboard](/guides/build-a-dashboard.md): Put charts, counters and task lists on one dashboard to see how the work is going.
- [Find anything (search, pins)](/guides/find-anything.md): Search tasks, lists, folders and views in every workspace, and pin the ones you open often.

### Work together

- [Invite members and grant permissions](/guides/invite-members-and-grant-permissions.md): Invite people to a workspace by email and choose the permission sets that decide what they can do there.
- [Share a folder or a list](/guides/share-a-folder-or-list.md): Give workspace members Read or Edit access to one folder, list or view, and keep a branch private.
- [Assign and watch tasks](/guides/assign-and-watch-tasks.md): Give a task to the member who does it, and choose who follows its changes as a watcher.
- [Comment and mention people](/guides/comment-and-mention.md): Discuss a task in its comments, bring a member in with an @mention, and point to another task with
- [See what changed in a task](/guides/see-task-history.md): Read a task's history — who changed what and when, including automations — and follow changes across a list or folder with a Feed view.
- [Estimate with Scrum Poker](/guides/estimate-with-scrum-poker.md): Estimate tasks with your team in a Scrum Poker (planning poker) session — hidden votes, a reveal, and story points written back to each task.

### Automate

- [Create an automation](/guides/create-an-automation.md): Build an automation from a preset or from scratch — a trigger, where it runs, conditions and actions — and check its run log.

### Connect

- [Set up notifications](/guides/set-up-notifications.md): Choose which events notify you in each workspace and where they reach you — the app, Telegram, desktop pop-ups or email — plus daily summaries, quiet hours and what a click on a notification shows.
- [Use the Telegram bot](/guides/use-the-telegram-bot.md): Connect the Hule bot to your account, see what is due and close tasks from Telegram, and act on notifications with one tap.
- [Use Hule from Raycast](/guides/use-raycast.md): Add, find and update Hule tasks from Raycast on your Mac, without opening the app.
- [Install the desktop app](/guides/install-the-desktop-app.md): Run Hule as an app on your computer — the Hule Do desktop app for macOS, Windows and Linux, or the web app installed from your browser — and on your phone.
- [Import from another tool](/guides/import-from-another-tool.md): Move folders, lists and tasks into Hule from ClickUp, Trello, Todoist, Notion, Yandex Tracker, Kaiten, WEEEK or another Hule account, by uploading an export file.
- [Manage your account](/guides/manage-your-account.md): Change how you sign in, your email and password, theme and language; set your name per workspace; download your data, delete your account, leave a workspace or sign out.

### Recipes

- [Run an inbox flow as a manager](/recipes/inbox-flow-for-a-manager.md): Catch every request from your team in one shared list and turn it into assigned work once a day.
- [Run iterative sprints by duplicating](/recipes/iterative-sprints.md): Run short sprints by duplicating last sprint's folder and carrying over what is left.
- [Plan a focus day with a timer](/recipes/focus-day-with-a-timer.md): Pick today's tasks in the morning and work through them one timer at a time.
- [Build a lead's dashboard](/recipes/lead-dashboard.md): See your team's load, overdue tasks and progress on one dashboard.
- [Automate the routine steps](/recipes/automations-that-do-work.md): Set up four automations on one list: assign new tasks, remind before the due date, raise overdue tasks to Urgent, and move finished tasks out.
- [Split a team's work into folders](/recipes/split-a-team-into-folders.md): Lay out folders and lists so every person and area of a small team has a clear place.
- [Give a contractor one branch](/recipes/give-a-contractor-one-branch.md): Let an outside person work in one folder while the rest of your lists and tasks stay hidden.
- [Keep personal and work tasks together](/recipes/personal-and-work-together.md): Run your personal tasks and your team's work side by side and plan your day across both.
- [Create tasks from Claude](/recipes/tasks-from-claude.md): Ask Claude to turn a conversation, a document or meeting notes into tasks in Hule.
- [Run a weekly review](/recipes/weekly-review.md): Close the week in half an hour: empty your Inbox list, check every list and plan the next week.
- [Build a second brain with relations](/recipes/second-brain-with-relations.md): Link tasks, ideas and notes to each other and find the connections later on the graph.

### Reference

- [Task fields](/reference/task-fields.md): Every field a task can have, what it holds and how a list turns it on.
- [Task IDs and series](/reference/task-ids.md): How a list numbers its tasks: series, patterns, padding and what happens when you change them.
- [Editor blocks and shortcuts](/reference/editor-blocks.md): Every block the task editor offers, its Markdown shortcuts, and what happens when you paste text, images and files.
- [Repeat rules](/reference/repeat-rules.md): How a recurring task picks its next date in each mode, what carries over, and when a series ends.
- [Views compared](/reference/views-compared.md): The eleven view types side by side (what each shows, what it supports, whether it works on mobile) and who sees User, Workspace and List views.
- [View filters](/reference/view-filters.md): Every filter field, operator and relative date a view offers, and how rules and groups combine.
- [View sorting](/reference/view-sorting.md): The fields a view can sort by, the Manual order, and how several sort rules combine.
- [View grouping](/reference/view-grouping.md): The fields a view can group by, which view types allow which groupings, and when a field is offered.
- [Keyboard shortcuts](/reference/keyboard-shortcuts.md): Every keyboard shortcut in Hule and how to change it.
- [Telegram bot commands](/reference/telegram-bot-commands.md): Every command and button of the Hule Telegram bot.
- [Automation triggers, conditions and actions](/reference/automation-triggers-and-actions.md): Every trigger, scope, condition, action, option, run-log status, limit and preset an automation can have.
- [Permissions and access](/reference/permissions-and-access.md): Every permission set and permission, and what read and edit access to a folder, list or view allow.
- [Limits](/reference/limits.md): Storage quotas, daily task and comment limits, and the maximum sizes of workspaces, imports, views and automations in Hule.

### API Reference

- [API — Authentication](/api/auth.md): Authentication and account management API endpoints — register, login, refresh tokens, and manage your session.
- [API — Tasks](/api/tasks.md): Task CRUD, search, move, and query endpoints. Manage tasks programmatically.
- [API — Recurring Tasks](/api/recurring-tasks.md): Create, manage, and edit recurring task series via the API.
- [API Examples](/api/examples.md): End-to-end API walkthroughs — authentication, task management, recurring tasks, and common workflows.