Skip to content

Session Commands

Session commands control the AI persona lifecycle. Starting a session activates the configured persona; ending it saves a summary and optionally backs up your data.

Starts a persona session. The AI persona becomes active with the name, tone, and behavior configured in buddy.config.ts.

What happens:

  • Persona activates with configured name and tone
  • All subsequent responses are prefixed with the persona name
  • Overdue items and commitments are flagged

Ends the active persona session.

What happens:

  • Session summary is generated
  • If backup.onEnd is true, content is automatically backed up to the data repo
  • Persona deactivates — Claude Code returns to normal operation

Manually backs up content to the data repo without ending the session.

What happens:

  • Content files (src/content/**/*.md) and buddy.config.ts are synced to the data repo
  • Equivalent to running bun data:backup

See Data Backup for setup instructions.