Task Management

As you use Kodik, every conversation is saved as a task after its first message starts a session. The task history panel shows started sessions immediately in the right workspace group, lets you navigate past work, pick up where you left off, and keep things tidy.

See Agent Overview for how tasks are structured.

Accessing Task History

Click the History button in the Kodik sidebar to open the task history panel. Tasks are sorted newest-first by default.

Browsing and Filtering

Search

The search bar filters tasks by their initial message text or by the workspace path they were started in. Searches are case-insensitive and match substrings.

Sort Order

Switch between Newest (default) and Oldest to change the sort order. Results are paginated; scrolling loads the next page automatically (100 tasks per page).

Task rows also show the latest status: working, needs you, done, failed, or stopped. Restored and imported tasks keep their settled status in history before you open them.

Filter by Workspace

Toggle Current workspace only to see only the tasks that were started in the workspace you have open right now.

Archived Sessions

Toggle Archived sessions to show sessions you have archived. Archived sessions are hidden from the normal history list but are not deleted automatically.

Favorites

Star a task to add it to your favorites. Toggle Favorites only to see only starred tasks.

Task Actions

Each task in the history list has the following actions:

• Open — resume the task in the Kodik chat. The agent’s conversation history, file state, and model are restored to where the task was last left. Long conversations also reload their earlier transcript when Kodik initially shows only the latest bounded tail.
• Rename — change the title shown in history and recent-session surfaces.
• Export — save the full API conversation transcript as a Markdown file. The export includes all messages, tool calls, and tool results from the task’s history.
• Archive / Unarchive — hide the task from the default history view or restore it from the archived view. Archiving keeps the session data on disk and does not schedule it for deletion.
• Delete — remove the task and its stored data, including its favorite marker and saved checkpoint/review snapshot. This action applies only to the selected task. If the task is open, its chat tab is removed; Kodik shows a new blank draft only when that was the last open tab.

Running Tasks and Windows

Active tasks keep running in the agent host even if you detach from the chat, reload the window, or open another window. When you reopen a task, Kodik loads a durable snapshot first and then follows new events from the host, so streaming text, tool waits, approvals, and questions catch up to the current state.

Each task has its own queue and status, and multiple tasks can run at the same time. If a tool needs the workbench UI, Kodik routes that request to the attached window; host-side file, search, and shell work can continue without an attached window, subject to the normal approval settings.

Starting a New Task

Click New Task (or use the keyboard shortcut) to start a fresh conversation. You can choose the workspace mode:

Local Mode

The agent works directly in your current workspace, reading and writing files in place. All changes are visible immediately in your editor alongside any other work in progress.

Worktree Mode

Kodik creates a dedicated Git worktree for the task under the .worktrees/ directory at your repository root. The agent works inside that isolated branch, so its changes are completely separate from your main working tree until you decide to apply them.

• Requires at least one Git commit in the repository (the worktree is branched from HEAD).
• The branch name is generated from the task title, prefixed with kodik/ by default (configurable via kodik.git.branchPrefix).
• Resume an existing worktree: the footer’s worktree menu lists the repository’s existing worktrees below New worktree — pick one to resume it. The new chat then runs inside that worktree, keeping its branch and uncommitted changes, instead of branching a fresh one. (The keep-limit cleanup below can still remove an aged worktree, so resume one before it is reaped.)
• While the task is active, the composer shows a Worktree badge. Open it to see the worktree name and reveal the folder in Explorer.
• Review actions such as Keep and Keep all accept pending review state inside the task worktree only; they do not patch your main checkout.
• To bring work back to your main branch, use the worktree folder/branch with normal Git workflows.
• Worktrees are kept after the task ends, after you undo its changes, and after you delete the chat — a worktree you started is never auto-removed for those reasons.
• When Automatically delete old worktrees is on (default), the keep limit (default: 15) is a hard cap: starting a new worktree force-removes the least recently active registered worktrees beyond the limit, including any uncommitted or unmerged work in them. Activity is based on files inside the worktree, not just when the folder was created. Worktrees used by running or restart-replayable tasks are spared, including tasks active in another Kodik window, and the same prune runs on startup. Turn the setting off to manage worktrees yourself.

Source control

The chat footer’s source-control menu switches branches and refreshes repository status through the workbench. If the host cannot complete one of those actions, Kodik reports the failure and keeps the current repository state rather than treating the unchanged branch as a successful switch.

Working directory

The working-directory selector in the chat input footer (to the left of the local/worktree menu) sets the folder a new session runs in. It defaults to the opened workspace folder.

• The button shows the working folder’s name. The menu lists the opened workspace folder(s), your recently-opened folders (the same list shown on the Welcome screen), and a Browse for folder… entry that opens your operating system’s folder picker — so you can point a session at any folder on your machine, including one outside the workspace.
• The chosen folder becomes the session’s working directory: every tool the agent runs (file reads/writes, terminal commands, glob, search) operates relative to it.
• The choice is persisted with the session (resuming restores it) and resets to the workspace default after you send, so a one-off folder choice never leaks into the next session.
• With worktree mode, the worktree is created from the chosen folder’s Git repository.
• If the chosen folder no longer exists when the session starts, it falls back to the workspace folder and tells you.
• If the folder picker or worktree listing cannot complete, Kodik reports the failure instead of silently treating it as a canceled pick or an empty worktree list.