# Overview, Needs you and Activity Each workspace has an Overview that shows what its tasks got done, where they ran and what waits on you. Open it from the workspace's **…** menu in the sidebar, or from the workspace's name in the breadcrumb at the top of the page. The sidebar lists every workspace you belong to, with its projects and their live sessions, and marks each session where the agent is waiting on your answer. Press `⌘K` (`Ctrl+K` on Windows and Linux) to find a session by title. For a record of what changed and who changed it, open Settings > your workspace > Activity. ## 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](https://kosuke.ai/docs/automate/sensei.md#what-the-counts-mean). - **Search**, with `⌘K` (`Ctrl+K`). It opens the command palette. See [Search tasks](https://kosuke.ai/docs/sessions/home-and-activity.md#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](https://kosuke.ai/docs/set-up/import-a-repository.md). Its **…** opens the workspace's menu: | Item | What it does | | ------------------- | ------------------------------------------------------------------ | | Overview | Opens the workspace's [Overview](https://kosuke.ai/docs/sessions/home-and-activity.md#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](https://kosuke.ai/docs/automate/crons.md) 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](https://kosuke.ai/docs/automate/crons.md). 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](https://kosuke.ai/docs/sessions/chat-sessions.md). ## Overview A workspace's Overview lives at `/w//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](https://kosuke.ai/docs/set-up/import-a-repository.md). ### 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](https://kosuke.ai/docs/help/desktop-and-mobile.md#use-kosuke-on-a-phone). ## 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](https://kosuke.ai/docs/automate/sensei.md#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](https://kosuke.ai/docs/sessions/messages.md) explains answering the agent, and [Sync with the Target Branch](https://kosuke.ai/docs/review/sync.md) 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. 1. 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. 2. 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](https://kosuke.ai/docs/help/keyboard-shortcuts.md). ## 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. 1. Open Settings > your workspace > Activity. 2. Pick a project to narrow the list, or leave **All projects**. 3. 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](https://kosuke.ai/docs/interfaces/cli.md). ## Next steps - [Chat sessions and tasks](https://kosuke.ai/docs/sessions/chat-sessions.md) - [Sensei](https://kosuke.ai/docs/automate/sensei.md) - [Keyboard shortcuts](https://kosuke.ai/docs/help/keyboard-shortcuts.md)