Cortask

Workspaces

Workspaces (referred to as "Projects" in the UI) are the organizational unit in Cortask. Each workspace has its own session history, file tree, memory store, and scheduled tasks.

Creating a Workspace

There are two ways to create a workspace:

  1. Welcome card -- when no workspaces exist, the Chat page shows a welcome prompt with a "New Project" button.
  2. Sidebar "+" button -- in the left sidebar under the "Projects" heading, click the "+" icon.

Both open a dialog with:

  • Name -- required. The display name for the project.
  • Folder -- optional. A file system path for the workspace root. Leave empty to use the default location inside the Cortask data directory. In the desktop app, a folder browser button is available.

Workspace Sidebar (Left)

The project list in the left sidebar supports:

  • Switching -- click a project name to make it the active workspace. This loads its sessions, file tree, and memory.
  • Reordering -- drag the grip handle on the left of each entry to reorder via drag-and-drop.
  • Edit -- open the context menu (three-dot icon) and select Edit to rename the project. The folder path is shown but not editable.
  • Remove -- select Remove from the context menu. A confirmation dialog explains that the folder and files will not be deleted; only the project entry is removed from Cortask.

Workspace Sidebar (Right)

When a workspace is active on the Chat page, a right-side sidebar appears with three resizable sections.

Files

Displays the workspace file tree in a hierarchical view with collapsible directories. Features:

  • Preview -- click any file to open it in the preview panel. Directories expand/collapse on click.
  • Add to chat context -- click the chat-plus icon on a file (or Ctrl+click) to select it as context for the next message. Selected files are highlighted and counted in the input area.
  • Context menu -- right-click a file or directory for Rename and Delete options. Files also have a Preview option.
  • Refresh -- the refresh button reloads the tree. The tree also auto-refreshes when the agent modifies files or when the window regains focus.
  • Open externally -- in the desktop app, a button opens the workspace folder in the system file explorer.

Memory

The memory section shows the workspace's knowledge base:

  • Recent entries -- when not searching, the section lists the 10 most recent memory entries with relative timestamps (e.g., "2h ago").
  • Search -- type in the search field to perform a debounced semantic search across memory entries. Results show the content, match type badge, relevance score, and timestamp.
  • Pinned notes -- click the pencil icon to open a dialog for editing the workspace's pinned memory notes in a monospace textarea.

Scheduled Tasks

Lists cron jobs associated with the active workspace:

  • Each job shows its name and an Active/Off badge.
  • Clicking a job navigates to the Cron page.
  • The "+" button navigates to the Cron page with the create form pre-filled for the current workspace.