Quick Install

Get Tycana running in under a minute with our professional installer.

One-Line Install (Recommended) ✨

Automatic installer with platform detection:

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

Features:

🔍 Smart Detection - Automatically detects your platform and architecture
🛡️ Security-First - Uses secure temp directories, minimal sudo usage
📁 User-Friendly - Prefers user-writable directories (no sudo required)
🎯 Professional - Homebrew-inspired experience with clear messaging

Custom installation directory:

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

Manual Installation

Latest Release

For manual installation, download the appropriate version for your system from our releases page.

💡 Tip: The one-line installer above is recommended as it always gets the latest version automatically.

🍎 macOS

Intel Mac:
tycana_VERSION_darwin_x86_64.tar.gz

Apple Silicon:
tycana_VERSION_darwin_arm64.tar.gz

🐧 Linux

x64:
tycana_VERSION_linux_x86_64.tar.gz

ARM:
tycana_VERSION_linux_arm64.tar.gz

🪟 Windows

x64:
tycana_VERSION_windows_x86_64.zip

ARM:
tycana_VERSION_windows_arm64.zip

Installation

macOS (Handles Gatekeeper automatically)

# Download and extract (replace VERSION with latest release number)
curl -L https://github.com/tycana/releases/releases/latest/download/tycana_VERSION_darwin_x86_64.tar.gz | tar xz   # Intel Mac
curl -L https://github.com/tycana/releases/releases/latest/download/tycana_VERSION_darwin_arm64.tar.gz | tar xz     # Apple Silicon Mac

# Run the install script (removes Gatekeeper quarantine)
./install-macos.sh

Linux

# Download and extract (replace VERSION with latest release number)
curl -L https://github.com/tycana/releases/releases/latest/download/tycana_VERSION_linux_x86_64.tar.gz | tar xz   # Linux x64
curl -L https://github.com/tycana/releases/releases/latest/download/tycana_VERSION_linux_arm64.tar.gz | tar xz     # Linux ARM64

# Install
chmod +x tycana && sudo mv tycana /usr/local/bin/

Windows

Download the zip file for your architecture
Extract the zip file
Add the directory containing tycana.exe to your PATH
Open a new terminal and verify with tycana version

First Steps

1. Add your first task

tycana add "Try out Tycana"

2. See your tasks

tycana list

3. Mark it done

tycana done <task-id>

4. Explore more

# See what's due today
tycana today

# Add a task with natural language
tycana add "Review docs by friday @project #urgent ~2h"

# Check your account status and usage
tycana account

# Check for updates
tycana version --update

# Get help
tycana help

Free vs Premium

Tycana offers a generous free tier with premium upgrades:

Free Tier

✅ 50 Active Tasks - Perfect for personal productivity
✅ All CLI Features - Full task management, natural language, time tracking
✅ Git Sync - Use your own repositories for backup and sync
✅ Data Ownership - Your tasks in plain YAML files

Premium Tier ($12/month)

✅ Unlimited Tasks - Scale without limits
✅ Cloud Sync - Seamless multi-device synchronization
✅ Web Dashboard - Access tasks from anywhere
✅ Priority Support - Direct help from our team

Check your usage:

tycana account    # Show current usage: Active tasks: 23/50

Upgrade anytime:

tycana upgrade    # Start 14-day free trial

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