Quick Install

Get Tycana running in under a minute.

Homebrew (Recommended)

brew install tycana/tap/tycana

Works on macOS and Linux. Updates with brew upgrade tycana.

Shell Installer

For systems without Homebrew, or if you prefer a direct install:

curl -fsSL https://raw.githubusercontent.com/tycana/releases/main/install.sh | bash

Detects your platform automatically. Custom install directory:

TYCANA_INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/tycana/releases/main/install.sh | bash

Manual Download

Grab the latest binary for your platform from the releases page. Extract it, put it on your PATH, and you’re set.

On macOS, run the included install-macos.sh script to clear the Gatekeeper quarantine.

First Steps

tycana add "Try out Tycana"       # Add your first task
tycana list                        # See your tasks
tycana done <task-id>              # Mark it done

Want cloud sync and calendar subscriptions? Log in with a magic link:

tycana account login               # Enter email, click the link — done

Tycana is free to use locally. Sync is $6/month.

System Requirements

macOS: 10.15 or later
Linux: Any modern distribution with glibc 2.17+
Windows: Windows 10 or later
Architecture: x64 or ARM64

Troubleshooting

macOS: “Apple cannot verify” error

If you get this error, use the included install-macos.sh script:

./install-macos.sh

This automatically removes the Gatekeeper quarantine and makes the binary executable.

“command not found”

Make sure /usr/local/bin is in your PATH:

echo $PATH

Permission denied

The binary might not be executable:

chmod +x /usr/local/bin/tycana