Start a focused work session on a specific project. Use when the user says "let's work on", "I'm focusing on", "deep work", "time to work on [project]", or wants to concentrate on a single project without distractions.
Set up and maintain a focused work context for a single project. The agent becomes a project-scoped collaborator — loading full context, suggesting next actions, and deflecting distractions to the inbox.
Determine which project to focus on:
get_brain_overview and ask which projectCall set_context to set the focused project.
Call get_project_context with to get:
include_note_content: "preview"Present a concise project dashboard:
[Project Name] [Description]
In progress: [list] Up next: [highest priority open tasks] Blocked: [any blocked items] Backlog: [count] (not shown in detail — these are unplanned) Recent notes: [titles]
Based on the project state, recommend what to work on:
"You were working on [task]. Want to continue, or pick something else?"
Mark the chosen task as in-progress with update_todo.
While the user is working in focus mode:
Capture stray thoughts to inbox: When the user mentions something unrelated to the current project:
"Got it — I'll save that to your inbox so you can deal with it later."
Call add_to_dump for the stray thought. Return focus to the project immediately. Do not switch context.
Track progress: When the user completes something:
done via update_todoAdd new tasks: If the user discovers new work during the session:
create_todo_in_projectWhen the user signals they're done ("that's enough", "I'm stopping", "wrapping up"):
Summarize what was accomplished:
"Good session. You completed [N] tasks on [project]: [list]. [M] tasks remaining."
Update any in-progress tasks that weren't finished — leave them as in-progress for next time
Offer to create a session note:
"Want me to save a note about what you worked on?"
If yes, call create_project_note with a session summary.
Mention if any stray thoughts were captured:
"I saved [N] items to your inbox during the session. You can triage them later."
set_context(project_name: project)
get_project_context(project, include_note_content: "preview")
→ present dashboard
→ suggest next action
→ update_todo(status: "in-progress") for chosen task
→ during session:
→ add_to_dump() for stray thoughts
→ update_todo(status: "done") for completions
→ create_todo_in_project() for discovered work
→ on wrap-up:
→ summarize
→ create_project_note() (optional)
brain-setup or brain-plan first