Reference

Command Reference

Core

Command	Purpose
`tycana add`	Create tasks with natural language
`tycana list`	View and filter tasks
`tycana done`	Complete tasks
`tycana edit`	Modify tasks
`tycana rm`	Remove tasks
`tycana undo`	Reverse last action

Views

Command	Purpose
`tycana view today`	Today’s priorities
`tycana view today --timeline`	Hourly timeline
`tycana view overdue`	Overdue tasks
`tycana view list`	Full filtered list
`tycana insights`	Productivity analytics

Organization

Command	Purpose
`tycana filter`	Saved filter management
`tycana context`	Switch between spaces
`tycana space`	Create and manage spaces (Sync)
`tycana timer`	Time tracking

Sync and Calendar

Command	Purpose
`tycana account`	Login, logout, status
`tycana sync`	Manual sync (`--force-push` for disaster recovery)
`tycana calendar`	Calendar subscriptions (Sync)
`tycana export calendar`	One-time ICS export
`tycana recur`	Recurring task templates (Sync)

Maintenance

Command	Purpose
`tycana config`	Configuration settings
`tycana archive`	Soft-delete tasks/projects
`tycana unarchive`	Restore archived items
`tycana cleanup`	Permanent removal
`tycana completion`	Shell completions
`tycana version`	Version and update check

Global Flags

These flags work on any command:

Flag	Short	Effect
`--quiet`	`-q`	Suppress styled output (exit code only)

Write commands (add, done, edit, rm) also accept:

Flag	Short	Effect
`--format json`	`-f json`	Output created/modified task as JSON
`--format yaml`	`-f yaml`	Output created/modified task as YAML

The list command also accepts --format csv for spreadsheet-friendly output.

Note: rm --format has no -f shorthand (-f is --force).

When --quiet and --format are combined, format output is preserved — quiet only suppresses styled text.

Exit Codes

Code	Meaning
`0`	Success
`1`	General error (config, storage, invalid flags)
`2`	Not found (task selector matched nothing)
`3`	Ambiguous (task selector matched multiple tasks)

Data Storage

~/.tycana/
  tasks/
    2026-02.yaml            # Monthly task files
  spaces/
    engineering/
      tasks/
        2026-02.yaml        # Space tasks
  config.yaml               # Settings

Tasks are plain YAML files. Human-readable, directly editable, yours to keep.

Configuration

`tycana config`

# View all settings
tycana config

# Get/set specific values
tycana config get telemetry.enabled
tycana config set telemetry.enabled true

# Open in editor
tycana config edit

# Reset to defaults
tycana config reset

# Show config file path
tycana config path

Archive and Cleanup

`tycana archive`

Soft-delete tasks or projects for future recovery.

tycana archive --project old-sprint
tycana archive --completed --older-than 90d
tycana archive --dry-run                 # Preview first

`tycana unarchive`

tycana unarchive --project old-sprint
tycana unarchive --dry-run

`tycana cleanup`

Permanently remove old completed tasks.

tycana cleanup --completed --older-than 90d
tycana cleanup --project archive
tycana cleanup --dry-run                 # Always preview first

AI Access via MCP Sync

Connect AI assistants like Claude to your tasks using the Model Context Protocol.

# Generate a token
# Visit https://app.tycana.com/dashboard/mcp

# Add to Claude Code
claude mcp add tycana -- \
  --transport streamable-http \
  --header "Authorization: Bearer YOUR_TOKEN" \
  https://app.tycana.com/mcp

Full setup guide: MCP Integration

Troubleshooting

Sync Issues

# Check if logged in
tycana account status

# Re-authenticate
tycana account logout
tycana account login

# Force manual sync
tycana sync

# Repopulate server from local data (disaster recovery)
tycana sync --force-push

Tasks are queued locally when offline. They sync automatically on the next write operation or manual tycana sync.

Calendar Not Updating

Verify the URL was copied completely
Only tasks with a due time appear (not just a date) — use friday 2pm or --due "2026-03-05 14:00"
Calendar apps poll every 15-60 minutes — wait and refresh
Check status: tycana calendar status
Regenerate if needed: tycana calendar regenerate

Getting Help

tycana help <command>                    # Command-specific help

Support: [email protected] — include the command you ran, the error message, and your OS.