⚡ Tiaga CLI

The AI Coding Assistant and Cloud Platform CLI for Modern Python
Vibe-code on the web, hack locally in your terminal, and ship instantly to production.

🌟 Overview

Tiaga is a developer-first terminal CLI and AI pair programmer. Designed with modern UX principles (collapsing inline spinners, scrollback-friendly terminal UI, fuzzy session restoration), Tiaga bridges the gap between AI code synthesis and cloud deployments:

• 🤖 Interactive AI Assistant: Powered by local or cloud LLMs (Gemma, Claude, GPT, Ollama) with tool execution (file editing, terminal commands, web search, sandboxing).
• 🔐 Unified Authentication: Single Sign-On (SSO) with Trivia and Blockhost Cloud with built-in 6-digit email OTP verification.
• ⚡ Zero-Config Dev Server: tiaga dev runs with automatic reload, file watching, and intelligent port collision detection.
• 🚀 Instant Cloud Deployments: tiaga deploy packages your project and deploys to Blockhost PaaS with auto-provisioned Let's Encrypt SSL via Caddy.
• 📜 Contextual Persistence: Project-scoped conversation history in SQLite with fuzzy session resumption (tiaga resume).

📦 Installation

# Clone the repository
git clone https://github.com/seems/Tiaga.git
cd Tiaga

# Install editable via uv or pip
uv pip install -e .

Verify installation:

tiaga --help

🚀 Quick Start

1. Authenticate with Your Cloud Account

tiaga login

If your email is not yet verified, Tiaga will automatically prompt you for your 6-digit verification code:

▲ Tiaga CLI • Blockhost Cloud Platform
! No active login found. Please sign in to your Trivia / Blockhost account:

? Email: developer@example.com
? Password: ••••••••••••

! Email Verification Required
A 6-digit verification code has been sent to developer@example.com.

? Enter 6-digit verification code: 554952
✔ Logged in as Developer <developer@example.com>

Check your identity anytime:

tiaga whoami

2. Start Chatting with AI

tiaga

╭──────────────────────────────────────────────────────────────────────────────╮
│           TIAGA  •  gemma4:31b-cloud  •  developer@example.com               │
╰──────────────────────────────────────────────────────────────────────────────╯

❯ create a FastAPI endpoint that parses markdown and returns HTML

Or pass a one-shot instruction:

tiaga "add CORS middleware to main.py"

🛠️ CLI Reference

🤖 AI Coding & Sessions

In-Chat Slash Commands

• /exit, /quit — Exit chat session.
• /clear — Clear terminal screen.
• /new — Start a fresh conversation session.
• /resume — Fuzzy pick a previous conversation.
• /model [NAME] — View or switch the active LLM.
• /config — Inspect current configuration.

☁️ Cloud & Ecosystem Commands

🏗️ Ecosystem Architecture

Tiaga operates as the terminal client within a unified 3-tier ecosystem:

┌────────────────────────────────────────────────────────┐
│              UNIFIED POSTGRESQL / USERS DB             │
│ id, email, auth_hash, nickname, email_verified_at, ... │
└───────────────────────────▲────────────────────────────┘
                            │
              ┌─────────────┴─────────────┐
              ▼                           ▼
 ┌───────────────────────────┐ ┌───────────────────────────┐
 │        TRIVIA API         │ │      BLOCKHOST PAAS       │
 │  • AI Code Generation     │ │  • Bare-Metal & Cloud VMs │
 │  • Workspaces & Sync      │ │  • Caddy Auto-SSL Routing │
 │  • 6-digit Email OTP Auth │ │  • Container Hypervisor   │
 └─────────────▲─────────────┘ └─────────────▲─────────────┘
               │                             │
               │        Tiaga CLI            │
               └──────────────┬──────────────┘
                              │
                    ┌─────────▼─────────┐
                    │    LOCAL SYSTEM   │
                    │ ~/.config/seems-  │
                    │ tiaga/auth.json   │
                    │ tiaga/sessions.db │
                    └───────────────────┘

1. Trivia Web: The visual canvas for vibe-coding and rapid prototyping.
2. Tiaga CLI: The hacker's terminal tool for local refinement, debugging, and terminal automation.
3. Blockhost: The compute engine that runs the containers, custom domains, and managed databases.

⚙️ Configuration

Tiaga stores state in standard user configuration directories:

• Credentials: ~/.config/seems-tiaga/auth.json
• Session History: ~/.config/seems-tiaga/sessions.db (SQLite)
• Local Project Link: .tiaga/project.json (inside linked project roots)

Environment Variables

• TRIVIA_API_URL — Trivia API server (default: http://127.0.0.1:8000).
• BLOCKHOST_API_URL — Blockhost control plane (default: http://127.0.0.1:8080).
• OPENAI_API_KEY / GEMINI_API_KEY / ANTHROPIC_API_KEY — API keys for local inference fallback.

📄 License

MIT License. Designed with ❤️ by the Seems engineering team.