Tillio CLI
Submit contributions, manage projects, and track evaluations — all from your terminal. One-line install on macOS and Linux.
$ curl -fsSL https://downloads.tillio.ai/cli/install.sh | sh -s -- --version 0.2.0Works on macOS and Linux. Detects your platform, downloads the right binary, adds it to PATH.
Prefer Python? (works on Windows too)
$ pipx install https://downloads.tillio.ai/cli/releases/0.2.0/tillio_cli-0.2.0-py3-none-any.whlRequires pipx (install via brew install pipx on macOS or pip install --user pipx on Linux/Windows). After install, run pipx ensurepath and reload your shell so the tillio command is on PATH.
Intel Mac, Linux, and Windows native installers coming soon — use the pip command above in the meantime.
Downloaded the macOS binary directly? (Gatekeeper bypass)
# Apple Silicon — /opt/homebrew/bin is on PATH by default chmod +x ~/Downloads/tillio-darwin-arm64 xattr -d com.apple.quarantine ~/Downloads/tillio-darwin-arm64 mv ~/Downloads/tillio-darwin-arm64 /opt/homebrew/bin/tillio tillio --version # Intel Mac — /usr/local/bin is the canonical location sudo mv ~/Downloads/tillio-darwin-arm64 /usr/local/bin/tillio
Quick Start
# Step 1: Install
$ curl -fsSL https://downloads.tillio.ai/cli/install.sh | sh -s -- --version 0.2.0
# Step 2: Authenticate
$ tillio login
# Step 3: Link your repo
$ cd my-project && tillio add
# Step 4: Submit work
$ tillio submit HEAD~3..HEAD
Submitting 3 commits to "my-project"... ✓ a1b2c3d — "Add payment processing" → 85 units ✓ d4e5f6a — "Fix auth middleware" → 42 units ✓ 7g8h9i0 — "Update README" → 12 units Total: 139 units earned
Command Reference
All commands support --help for inline documentation. Global flags apply to every command.
Global Options
| --version | Show CLI version |
| -o, --output {table|json|yaml} | Output format(default: table) |
| --no-color | Disable colored output (also honors NO_COLOR env var) |
Submit commits as contributions for AI evaluation.
Usage
tillio submit [OPTIONS] [COMMIT_RANGE]Options
| --project-id TEXT | Tillio project ID (auto-detected from repo URL if not set) |
| --dry-run | Preview what would be submitted without sending |
| --full-context | Include code diffs for richer AI evaluation |
| --no-context | Force summary mode (metadata only) |
Examples
tillio submit # last commit (HEAD) tillio submit HEAD~3..HEAD # last 3 commits tillio submit abc123 # specific commit tillio submit --dry-run # preview only
Configuration
The CLI stores config in ~/.tillio/config.yaml. Environment variables take precedence over the config file.
~/.tillio/config.yaml
api_key: tillio_abc123... api_url: https://api.tillio.ai
| Field | Env Override | Description |
|---|---|---|
| api_key | TILLIO_API_KEY | Your Tillio API key |
| api_url | TILLIO_API_URL | API base URL |
| NO_COLOR | NO_COLOR | Disable colored output (env only) |
Output Formats
All commands support three output formats via the -o flag — ideal for scripting and automation.
table (default)
$ tillio projects ┌──────────┬────────────┬────────┐ │ ID │ Name │ Status │ ├──────────┼────────────┼────────┤ │ proj_456 │ my-project │ active │ └──────────┴────────────┴────────┘
json
$ tillio -o json projects
{"id":"proj_456","name":"my-project","status":"active"}yaml
$ tillio -o yaml projects id: proj_456 name: my-project status: active
Shell Completions
Tab completion for all commands and options:
$ tillio completion zsh --install ✓ Completion installed to ~/.zshrc
Build Something Worth Sharing
Join teams already using Tillio to track contributions, automate evaluation, and distribute payouts — no spreadsheets, no trust gaps.
FAQ
Explore our FAQs for fast, informative answers to frequently asked questions and common concerns.
Tillio supports six contribution categories: Technical (code, infrastructure), Research & Intellectual (analysis, expertise), Product & Design (UI/UX, specifications), Marketing & Distribution (content, outreach), Business & Enablement (operations, partnerships), and Stewardship & Risk (governance, compliance).
Can't see your question listed above? Visit our Help Center