Exporting Tasks to Hamster

The export command takes your local task plan and creates a collaborative brief on Hamster. This is how you go from solo development to team collaboration.

Usage

tm export

The command walks you through:

  1. Tag selection — Choose which tags to export (multi-select supported)
  2. Authentication — OAuth login if not already authenticated
  3. Brief creation — Hamster generates a brief with auto-generated title and description
  4. Team invitations — Optionally invite team members
  5. Context switch — Your CLI context automatically switches to the new brief

Inviting Team Members

# Export and invite teammates in one step
tm export --invite

You can invite up to 10 team members by email during export. The terminal shows invitation status and a clickable invite URL for sharing.

What Hamster Does

When you export, Hamster:

  • Reverse-engineers a PRD from your task list
  • Generates brief titles and descriptions from task content
  • Imports all tasks across your selected tags
  • Handles all AI inference — your teammates don't need their own API keys

PRD to Hamster

You can also send a PRD directly to Hamster instead of parsing it locally:

tm parse-prd my-prd.txt
# Select "Bring to Hamster" when prompted

Hamster creates a collaborative brief from your PRD content, generates tasks, and optionally invites your team — all in one step.

After Exporting

Once exported, you can immediately start working in team mode:

# See your exported tasks
tm list

# Find the next task
tm next

# Watch for team changes in real-time
tm list --watch

Already-exported tags are disabled in the export selector to prevent duplicate exports.