Sitemap
Every page of task-ui, by area: what it lists, the actions at the top right of its head, the actions of a row, its forms and what an empty list shows. Development has the conventions the pages follow. A row action in [...] is an item of the row’s ⋯ menu; “Delete” and “Remove” are in red, last.
Runs and work
| Page | Path | Lists | Head, top right | Row actions | Forms | Empty |
|---|---|---|---|---|---|---|
| Dashboard | / |
running terminals as tiles | [...] Add: workspace, project, user, key, variable, workflow, as far as the user may |
Run, Attach on a tile | none | “Nothing is running.” |
| Runs | /runs |
every run, newest first, with filters; Activity and Tooling folds | none | View or Attach, [...]: open, replay, Summary, Stop, Kill |
the filter bar | “No runs match.” |
| Run | /runs/<id> |
the terminal, its output, the run’s details, its artifacts | View or Attach, Stop, Kill, Report, Replay | artifacts: [...] |
the prompt about the run | “None: a job keeps files by writing them to $TASK_UI_ARTIFACTS.” |
| Report | /runs/<id>/report |
the question and Claude’s answer | Run, Claude’s run, Job | none | none | none |
| Workflows | /workflows |
the workflows, each with its schedules and last run; Recent runs, each with its state dot and its answer open under it | Add workflow | Run or Stop, [...]: Edit, the run going; a recent run: the chevron that folds its answer |
the Prompt box | “No workflows yet.” |
| Add workflow | /workflows/new |
none | none | none | name and steps, Cancel and Save | none |
| Workflow | /workflows/<id> |
its pipeline and its runs, each with its state dot and its answer folded under a chevron | Run or Stop, Edit | runs: the chevron, View, [...] |
the runs’ filter | “Not run yet.” |
| Edit workflow | /workflows/<id>/edit |
the steps; Schedule, the workflow’s schedules | [...]: Open, Delete |
a step’s [...]: Move up, Move down, Duplicate, Remove; a schedule’s [...]: Enable or Disable, Delete |
the step editor, Save; Add schedule: expression, Run as | “Not scheduled.” |
| Workflow run | /workflows/<id>/runs/<run> |
the run’s thread, its question and answer, the steps of the run, each its run, and Prompts, the threads of its prompt and summary steps, open while it runs and folded once it ends | none | View on a step | none | none |
| Artifacts | /artifacts |
Space, Files of the tree, History | [...]: Delete all |
Files and History: [...]: open, download, copy the link, Delete |
the History filter | “This folder is empty.”, “No artifacts yet.” |
| Artifact file | /artifacts/files/<path>?version= |
the file itself, inline; ?download saves it; a directory goes to its listing |
none | none | none | none |
| Artifact archive | /artifacts.tgz, /artifacts/<directory>.tgz |
the tree, or a directory of it, as a .tgz of the files you see |
none | none | none | none |
| Scheduled | /schedules |
every schedule, of a job or a workflow | none | [...]: Enable or Disable, Delete |
Add schedule: folder, job, args, expression, Triage failures with Claude, Run as | “No schedules yet.” |
| Notes | /notes |
notes and their replies | none | a note’s [...]: Edit, Open its run, Delete |
the note box, Post note | “No notes yet.” |
| Inventory | /inventory |
hosts by cluster, Run on the hosts | none | the ssh login to copy inline, [...]: open, copy ssh |
Run on the hosts | “Beszel isn’t monitoring any hosts.” |
| Host | /inventory/hosts/<name> |
the host’s charts and details | none | none | none | none |
| Module | /m/<vendor>/<name> |
whatever the module renders, inside the layout, with the render time in the footer | the module’s own | the module’s own | the module’s own | the module’s own |
| Refinement | /m/titpetric/refinement |
the threads, and one thread’s comments with the index of its artifacts | none | a thread: Open | what to design, Start a thread; a comment, Send | “No threads yet.” |
Folders
| Page | Path | Lists | Head, top right | Row actions | Forms | Empty |
|---|---|---|---|---|---|---|
| Workspace, project or folder | /f/<workspace>/<folder> |
the git line, Files, on a workspace Home, its home’s files, the folder’s details, its block head | a workspace with no project: Add project; [...]: Add project, Pin or Unpin, Workspace or Project settings, a workspace’s SSH keys and Secrets, Add schedule, Pull now, Remove checkout |
a file: [...] |
the Prompt box | none |
| Directory | /f/<folder>/<dir> |
the git line, Files | [...]: Pin or Unpin |
a file: [...] |
the Prompt box | none |
| Job | /f/<folder>/<job> |
the job, History, Schedules | Run, or Attach and Kill | History: View or Attach, [...]; Schedules: [...] |
Add schedule | “No runs yet.”, “Not scheduled.” |
| Checkout file | /files/<path> |
the file in the preview window | none | none | none | none |
Settings
| Page | Path | Lists | Head, top right | Row actions | Forms | Empty |
|---|---|---|---|---|---|---|
| Settings | /settings |
the setup steps in order | none | Open | none | none |
| Instance | /settings/instance |
General, Runs, Parent environment, Paths, Storage for an admin, Integrations, Keys | none | Keys: the keys table; Parent environment: the server’s variables by name, forwarded or not, sensitive flagged, for an admin; Storage: an item a row, where, size and files, with a total, an ellipsis while a measure is under way | the backlog length, the parent environment’s None, Auto or All | a missing key’s Generate and Upload |
| Data retention | /settings/retention |
the rules and what each keeps | Clean up now | none | the rules, Save | none |
| Telemetry | /settings/telemetry |
none | Open the dashboard | none | the recorder’s settings, Save | none |
| Sidebar | /settings/sidebar |
the sidebar’s items in order, with their links and a Shown switch | none | a row: the grip, [...]: Move up, Move down |
the table, Save | none |
| Keys | /settings/keys |
Scopes, Every key, Who gets which key | Upload key, Generate key | the keys table | none | “No keys added.” |
| Upload key, Generate key | /settings/keys/upload, /generate |
none | none | none | the key, Cancel and Upload or Generate | none |
| Key | /settings/keys/<name> |
none | none | none | its links, Cancel and Save | none |
| Secrets and env | /settings/secrets, ?workspace=<folder> for one workspace |
every variable with its scope, secret or env, and the environment the integrations compute for the user, read only | Add variable | a row: [...]: Edit, Reads, Delete |
none | “No variables yet.” beside Add variable |
| Add variable, Edit | /settings/secrets/new, /edit |
none | none | none | scope, name, value, the secret checkbox, Cancel and Save | none |
| Reads | /settings/secrets/<id>/reads |
the runs that got a variable | Secrets | none | none | “No run got yet.” |
| Integrations | /settings/integrations |
a card per service on a rail | Fold all | Clear | the service’s settings and variable switches, Save; Forgejo: Sync now, Dry run, and the line on the push hook and the last sync, a link to its run | none |
| Users | /settings/users |
the users, Connect an MCP client | Add user | [...]: Edit, Profile, Runs, Delete |
none | none |
| Add user | /settings/users/new |
none | none | none | name, password, Cancel and Add user | none |
| Permissions | /settings/permissions |
a matrix per role, with the role’s users and keys above it | Add user and Generate key in a role’s block | none | the matrices, Save | none |
| Workspaces | /settings/workspaces |
the workspaces, their home repositories and projects | Import, Add workspace | [...]: Open, Workspace settings, Add project, SSH keys, Secrets, Move up, Move down, Delete; a project or variable count of none carries “add” |
Import in a dialog | none: internal always lists; “empty” for a workspace without a home repository |
| Add workspace | /settings/workspaces/new |
none | none | none | folder, title, description, home repository and home branch, Recursive, Cancel and Add workspace | none |
| Workspace settings | /settings/workspaces/<folder>, internal too |
Settings, Home repository, Projects, Keys | Add project, Export, [...]: Open, Delete |
Home repository: Pull now, Replace or Clone, Remove; Projects: the projects table; Keys: the keys table | Settings, Cancel and Save; Replace in a dialog; Export in a dialog | “The home is an empty directory.” beside Clone; “No projects in yet.”; “No keys added.” beside Upload key and Generate key |
| Workspace keys | /settings/workspaces/<folder>/keys |
the workspace’s SSH keys, each to every run of the workspace | Upload key, Generate key, [...]: Open, Workspace settings, Secrets |
the keys table | Upload and Generate in dialogs | “No keys added.” |
| Workspace key | /settings/workspaces/<folder>/keys/upload, /generate |
none | none | none | as the instance key’s forms, without the links | none |
| Projects | /settings/projects |
a block per workspace: the folders at the top of the root, then each workspace’s projects | Add project | a workspace’s block: Add project into it; the projects table: [...]: Open, Project settings, Pull now, Remove checkout |
none | “No projects yet.”, “No projects in yet.” |
| Add project | /settings/projects/new, ?workspace=<folder> |
none | none | none | repository, folder, workspace, branch, Cancel and Clone | none |
| Project settings | /settings/projects/<folder> |
its jobs’ rules | [...]: Remove checkout |
none | title, who can run, workspace, sources, per job, Cancel and Save | none |
You
| Page | Path | Lists | Head, top right | Row actions | Forms | Empty |
|---|---|---|---|---|---|---|
| Profile | /users/<name> |
Runs, Workflow runs, Notes, Prompts, Keys for your own or with key/view |
Edit for your own or with user/edit, [...]: Runs by this user, Delete |
Runs: View or Attach, [...]; Workflow runs: View; Keys: the keys table, Generate key, Upload key |
none | “No runs yet.”, “No workflow runs yet.”, “No notes yet.”, “No prompts yet.” |
| Edit user | /users/<name>/edit |
Roles, Folders, Permissions, Keys, MCP access | View profile | Keys: the keys table, Generate key, Upload key | Roles, Folders, each Cancel and Save; Permissions, Save; MCP Enable or Rotate | “No key linked to .” |
| Your SSH keys | /keys |
the keys your runs get | Generate key, Upload key with key/edit, for yourself |
the keys table | none | “No keys for you or your role yet.” |
| Sign in | /login |
none | none | none | name, password | none |
Shared parts
| Part | Template | Where |
|---|---|---|
| Keys table | keyhead, keyrow |
Keys, Instance, a workspace’s page and its SSH keys page, Your SSH keys, a user’s edit page |
| Secret fields | secretfields |
Add variable and Edit |
| Files table | tree, filetable |
a folder’s Files and a workspace’s Home, a directory’s page |
| Projects table | projecttable |
each block of Projects, a workspace’s page |
| Block head | blockhead, from head |
a block’s title, its note, its buttons and the line of an empty list |
| Buttons | buttons |
the buttons of a block head |
| Copy | copyable |
a public key, an ssh login, the MCP links and command, a token shown once |
| Row menu | menu |
every row and page head with actions besides its main one |