Reference

Command Reference

Core

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

Organization

Command	Purpose
`tycana context`	Switch between spaces
`tycana space`	Create and manage spaces (Sync)
`tycana timer`	Time tracking
`tycana insights`	Productivity analytics

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 cleanup`	Remove old completed tasks
`tycana completion`	Shell completions
`tycana version`	Version and update check

Global Flags

Flag	Effect
`--quiet` / `-q`	Suppress styled output (exit code only)
`--format json` / `-f json`	JSON output
`--format yaml` / `-f yaml`	YAML output
`--format csv` / `-f csv`	CSV output (`list` only)

--quiet works on all commands.
--format works on add, done, edit, rm, list, and show.
On rm, use --format not -f (-f is --force).
When both 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

Cleanup

`tycana cleanup`

Permanently remove old completed tasks.

tycana cleanup --completed --older-than 90d
tycana cleanup --project old-sprint
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.