The sidebar
From the top, the sidebar holds:
- Sensei. It shows Sensei's face and one count: how many of your Sensei threads have something waiting on you or something new. See Sensei.
- Search, with
⌘K(Ctrl+K). It opens the command palette. See Search tasks. - Workspaces, with Filter tasks, Sort tasks and a + that opens the shared demo dialog for a new workspace.
- Every workspace you belong to, the ones you created or joined.
- A card for each invitation waiting for you, such as "Acme invited you". Press Join to join that workspace.
- Settings and Upgrade.
There is no New session row in the sidebar. Press ⌘J (Ctrl+J) on any page to open the New Session dialog. The open project's session list also ends with a New session row.
A workspace row shows the workspace's tile and name. Click the row to fold or unfold the workspace. A caret after the name shows on hover and stays while the workspace is folded. Sensei remembers which workspaces you folded. The workspace of the project you have open does not fold.
Hover a workspace row for two buttons. Its + imports a repository into that workspace. See Import a repository. Its … opens the workspace's menu:
| Item | What it does |
|---|---|
| Overview | Opens the workspace's Overview. |
| Import a repository | Opens the Import Project dialog for the workspace. |
| Invite members | Opens Settings > your workspace > Members. |
| New cron | Opens the workspace's Crons page on a new cron. |
| Acme settings | Opens the workspace's Settings. The item names the workspace. |
Under a workspace are its projects. Click a project's name to open the project and list its sessions. Hover a project and its folder icon turns into a caret. Click the caret to show or hide the project's sessions without leaving the page. Sensei remembers this for each project. A project's … menu holds its actions. A workspace with no projects shows an Import repository row where its first project will sit. It opens the Import Project dialog for that workspace.
A workspace with at least one cron also shows a Crons row under its projects. It shows how many crons the workspace has, and a red dot when the last run of one of them failed. Click it to open the workspace's Crons.
A project row can carry one deploy mark:
| Mark | Meaning |
|---|---|
| Setup | Muted text on the right. The project has never deployed. The row opens its settings. |
| Spinner | A deploy is running. During the first deploy it shows the step, such as 2/4. |
| Yellow dot | The deploy agent is waiting for your input. |
| Red dot | The last deploy failed. |
Each session shows at most one status mark, in this order:
| Mark | Meaning |
|---|---|
| Merge or archive icon | The session is Completed or Archived. |
| Green dot | The branch was merged. |
| Spinner | The agent is working. |
| Pulsing amber dot | The agent is waiting on your answer. Shown only to the session's Assignee, or to every member while the session is Sensei's. |
| Red dot | The last turn failed. |
| Solid dot | Unread. The agent finished, or the session was reassigned to you, since you last looked. Shown only to the Assignee, or to every member while the session is Sensei's. |
A PR badge marks a session whose pull request has not merged, including an Archived session whose pull request was closed. Its color says whether the pull request needs attention, is waiting on checks, is ready to finish, or is under review. Hover over it for the checks and conflicts. A sandbox icon appears while the session's sandbox runs. Press it to stop the sandbox.
A project lists its Active and Under Review sessions by default, most recent activity first.
Filter tasks beside Workspaces filters every expanded project's tasks by Status, Assignee and Priority. Status offers Active, Under Review, Completed and Archived; clear every status to list no tasks. Assignee offers members across the workspaces you can access, with You first, plus Sensei, Assigned and Unassigned. Assigned and Unassigned clear one another while keeping member selections. Clear every Assignee or priority to include them all. Choices within a section combine; sections narrow one another. A selected member who is no longer listed stays as Unknown member so you can remove them.
Sort tasks offers Activity, Created and Priority; select the same field again to reverse its direction. Sensei remembers these filters and sort across projects, workspaces and reloads, independently of the Tasks page and Sensei filters. Filtering out the task you have open keeps its conversation open. Task keyboard shortcuts follow the filtered, sorted rows. Right-click a task for Open chat, Share, Rename, Priority, Assignee, View on GitHub, Archive and Delete. See Chat sessions and tasks.
Overview
A workspace's Overview lives at /w/<workspace>/overview, and its title reads the workspace's name, then Overview. It covers that workspace's tasks only. Personal tasks are not in it. There is no Overview across workspaces. An old link to /home opens the Overview of the workspace you opened most recently. Nothing on it changes a task; each row opens the task, thread or repository it names.
The Overview shows your own work at first. Use the filters at the top to widen or narrow it:
| Filter | Options | Starts on |
|---|---|---|
| Assignee | One or more members, plus Sensei, Assigned and Unassigned. Clear every choice for All Assignees. | You |
| Repository | All repositories, or one of the workspace's repositories. One repository leaves out tasks with no repository. | All repositories |
| Date range | This month, 7d, 30d, 90d, or two dates that span up to 366 days, counting both. | Last 30 days |
Sensei remembers your filters for each workspace.
A workspace with tasks but no repository still shows its tasks, without the Repository filter. When a workspace has neither, its Overview reads "Nothing here yet", with Add a project to import a repository. See Import a repository.
Figures and chart
| Figure | What it counts |
|---|---|
| tasks done | Tasks done in the date range, by the day each was done, with the change on the range before it. |
| in progress now | Tasks Active or Under Review right now. |
| need you now | Your own Sensei threads of this workspace with an open card, right now. The filters do not change it. |
| PRs merged | Pull requests merged in the date range, with how many were opened. |
| credits spent | The retail value of the workspace's cloud usage in the date range. An enterprise plan sees cloud hours instead. |
A dash means the figure could not be read. The chart below shows tasks done per day, stacked by whether each ran: Sandbox, or No execution for a task that never ran. Hover over a day to see its numbers, or select it to keep them open. Days are in your own timezone.
Panels
| Panel | What it shows |
|---|---|
| Waiting on you | Your Sensei threads of this workspace with an open card, whatever the filters say. Select one to open it in Sensei, where you answer the card. |
| Tasks created in the period | Tasks created in the date range, by how each was filed, largest first: Members in the app, Sensei threads, Sensei messages and events, GitHub pull requests, Task agents, CLI and API, Crons, Merge agent, or Connected assistants. Tasks filed before Sensei recorded this show as Filed before a date; Other or unknown is the rest. Hover a row for what it counts. |
| Repositories | Each repository's tasks in progress, tasks done, pull requests merged, and spend or hours. Select a name to open it. |
| Recently done | Tasks done in the date range, newest first. Select one to open the task. Press Show more for older ones. |
On a phone
The Overview needs a computer. In the iOS app, and in a window narrower than 768 pixels, it shows "Open this on a computer" with a Copy link button. See Desktop app and mobile.
Needs you
Something needs you when Sensei puts a card in front of you. What happens to your sessions, such as failed checks, a failed turn, a question from the agent, a stop of /kosuke:ship, an approval or a review request from a teammate, reaches the Sensei thread that holds the session as an event. Sensei decides whether to draw a card for it, with the button that decides it. A thread with an open card, or a Post you have not opened, is in Needs you.
The Threads tab of the Sensei page lists those threads first, across every workspace. The count beside Sensei in the sidebar and on the desktop app's menu-bar icon counts them, and the iOS app's badge counts your open cards. A session card in the lists shows no Needs you cue. See Decide what needs you. In the sidebar, a pulsing amber dot marks a session where the agent waits on your answer, and a red dot one whose last turn failed. Messages, Up next and steering explains answering the agent, and Sync with the Target Branch explains a branch that is behind.
Your open cards are available from the CLI with kosuke sensei cards list.
Search tasks
Press ⌘K (Ctrl+K), or Search in the sidebar.
- Type part of a task's or thread's title. With nothing typed, the palette lists your first threads and the first 10 tasks, as the Sensei page lists them.
- Pick a result. It opens the task, or the details of a Backlog task.
Threads keep the order of the Sensei page's Threads list: pinned threads first, then the sort you chose there. A thread row shows a pin when you pinned it and a dot in its state's colour: amber for Needs you, blue for Working, green for Done. Tasks keep the order of the Tasks column: In Progress, then Todo, then Completed, each in the sort you chose for it. A task row shows its repository. The search covers every workspace you belong to and leaves out Archived tasks. For every shortcut, see Keyboard shortcuts.
Workspace Activity
Activity is the workspace's log of what changed and who changed it, kept for 30 days. Every member can read all of it.
- Open Settings > your workspace > Activity.
- Pick a project to narrow the list, or leave All projects.
- Pick All, Changes or Member actions.
| Tab | What it lists |
|---|---|
| Changes | States Sensei observed. Checks fail or pass, a pull request merges, a branch falls behind, the agent waits for an answer, or a Cron run succeeds or fails. |
| Member actions | What a named member did. They started, sent to, archived, deleted, assigned or moved a task, or changed its priority. They created, paused, resumed, edited or deleted a cron. They invited or removed a member, or changed a role. |
Sending to a task is recorded once per member, task and day. Each event shows its time: how long ago for today, then Yesterday or the date. Press the Open task icon on a row to go to its task.
A dot marks each event that is new since your last visit. Your own actions are never new to you. Opening the page marks everything in the workspace as seen, and the dots stay until you close it.
To read Activity from a script, use kosuke activity list. kosuke agent summary get prints what needs you and your new Activity in one digest. See Sensei CLI.