Sync & Calendar

Cloud Sync Sync

# Log in
tycana account login
# Enter email > check inbox > click magic link > done

# Manual sync (bidirectional)
tycana sync

# Check status
tycana account status

# Sign out
tycana account logout

Write operations (add, done, edit, rm) automatically push changes to the server. Use tycana sync to pull remote changes from other devices.

Disaster Recovery

If the server database is lost, your local tasks are safe in YAML files. Push everything back:

tycana sync --force-push

This pushes all local tasks (personal and spaces) to the server. Existing tasks are updated by ID, new ones are created. Safe to run multiple times.

Multi-Device Workflow

  1. Add task on laptop — auto-syncs to server
  2. Run tycana sync on desktop — task appears
  3. Complete task on desktop — auto-syncs back
  4. Run tycana sync on laptop — completion reflected

Calendar Integration Sync

Tasks with a specific time automatically appear in your calendar.

Setup

# Create a calendar subscription
tycana calendar subscribe

# Get the URL
tycana calendar status
# https://app.tycana.com/calendar/<uuid>

Add the URL as a subscription in your calendar app:

  • iPhone/iPad: Settings > Calendar > Accounts > Add Account > Other > Add Subscribed Calendar
  • Google Calendar: Other calendars (+) > From URL
  • Apple Calendar: File > New Calendar Subscription
  • Outlook: Add calendar > Subscribe from web

Tasks update automatically. Only tasks with a due time (not just a date) appear as calendar events. Add a time with natural language (friday 2pm) or the --due flag (--due "2026-03-05 14:00"). The CLI shows a hint when a task has a date but no time.

Space Calendars

Each space can have its own calendar feed.

tycana space calendar                    # Current space status
tycana space calendar --list             # All space calendars

Calendar feed URLs are also available on your dashboard.

Managing Subscriptions

tycana calendar regenerate               # New URL (invalidates old one)
tycana calendar unsubscribe              # Remove subscription