Keep your projects tidy
Agents create a lot quickly: conversations, docs, workflows, branches. Without a little upkeep, it gets hard to see what’s active. These habits keep each screen showing what matters now.
Projects
- Pin what you’re working on. Pinned projects keep a tile on the shelf, the row of projects at the top of the window. Select All at the end of the shelf and turn on the pin switch next to a project, or right-click a project’s tile and choose Pinned. Other projects stay under All. Drag a tile along the shelf to reorder it, or off the shelf to unpin it. With projects pinned, press ⌘1 to ⌘9 on a Mac, or Ctrl+1 to Ctrl+9 on Windows and Linux, to jump between them.
- Give each project its own color. In Project settings, choose a Tint color or add an image with Choose image…, then select Save. You can also right-click the project’s tile on the shelf and pick a color in its menu. The color shows on the project’s tile and on buttons inside the project, such as Mark as completed, so you can tell at a glance which project you’re in.
Conversations
- Mark finished work completed. It leaves the conversation list’s Active for Completed, so Active lists only what’s still in progress. See Mark finished work as completed.
- Snooze what isn’t for now. A conversation you’ll come back to doesn’t have to sit in Active. Snooze it until a time you choose, and it comes back on its own. See Snooze a conversation.
- Let labels do the naming. Agents label each new conversation in three to six words. You can rename a conversation’s title and its label, but a focused first message gets a useful label from the start. See Use one conversation per task.
- Search before scrolling. The search icon at the top of the list, or ⌘F (Ctrl+F on Windows and Linux), opens a search box that finds words in any message, the agent’s questions, and conversation labels. It looks through the status the list shows, and a search from Active looks through everything, completed conversations too. Press Esc to clear it.
- Fit more on screen. Select your face at the top right of the navigator and choose Appearance, then choose Compact beside Conversations. Choose what to show turns the message preview, agent, and date on or off.
- Hide the list when you’re focused. In Conversations, press ⌘\ on a Mac or Ctrl+\ on Windows and Linux. The whole column on the left, navigator included, hides until you press it again or select Show conversation list at the top of the conversation.
Docs and workflows
- Pin the docs you use daily. Select Pin document in a doc. Pinned docs come first in Files, and stay in its list under Pinned documents while you browse the project’s folders.
- Archive what’s out of date. Choose Archive document from the doc’s Document actions menu. Archived docs leave your list and the @ picker, and agents don’t see them when they list your docs.
- Group workflows. In Workflows, choose New collection from the list’s title, All workflows. Then choose that collection from the first menu under a workflow’s title.
- Pin the workflows you run most. Point at a workflow’s line, select its ⋯ button, and choose Pin to top. In All, it appears first, under Pinned. See Pin or duplicate a workflow.
An example
Every Friday, you spend five minutes on cleanup. You complete the conversations whose work you checked, archive the handoff docs from finished features, and unpin the project you shipped. On Monday, your shelf shows only this week’s projects, and each list starts with what’s still open.
Common pitfalls
- Deleting instead of completing. Delete conversation removes the history, and on the computer and in the web app it doesn’t ask first. Completed conversations stay searchable.
- Pinning everything. Pins help only when there are few of them. The web app keeps its own project pins, and pinned docs are saved separately on each device.
- Keeping stale docs around. Agents may follow an old plan you’ve since changed.