Titan CLI

Modular development tools orchestrator - Streamline your workflows with AI integration and intuitive terminal UI

Titan CLI is a powerful command-line orchestrator that automates Git, GitHub, JIRA workflows through an extensible plugin system with optional AI assistance.

✨ Features

🔧 Project Configuration - Centralized .titan/config.toml for project-specific settings
🔌 Plugin System - Extend functionality with Git, GitHub, JIRA, and custom plugins
🎨 Modern TUI - Beautiful terminal interface powered by Textual
🤖 AI Integration - Optional AI assistance through direct providers and LLM gateways
⚡ Workflow Engine - Compose atomic steps into powerful automated workflows
🔐 Secure Secrets - OS keyring integration for API tokens and credentials

📦 Installation

For Users (Recommended)

# Install with pipx (isolated environment)
pipx install titan-cli

# Verify installation
titan --version

# Launch Titan
titan

Note: This installs the stable production version. You only get the titan command.

For Contributors (Development Setup)

See DEVELOPMENT.md for complete development setup.

Quick start:

# Clone repository
git clone https://github.com/masorange/titan-cli.git
cd titan-cli

# Setup development environment
make dev-install

# Run development version
titan-dev

Note: Development setup creates a titan-dev command that runs from your local codebase, allowing you to test changes immediately. This command is not available to end users who install from PyPI.

🚀 Quick Start

First Time Setup

# Launch Titan (runs setup wizards on first launch)
titan

On first run, Titan will guide you through:

Global Setup - Configure AI connections (optional)
Project Setup - Enable plugins and configure project settings

Basic Usage

# Launch interactive TUI
titan

# Or run specific workflows
titan workflow run <workflow-name>

🔌 Built-in Plugins

Titan CLI v1.0.0 includes three core plugins:

Git Plugin - Smart commits, branch management, AI-powered commit messages
GitHub Plugin - Create PRs with AI descriptions, manage issues, code reviews
JIRA Plugin - Search issues, AI-powered analysis, workflow automation

🤖 AI Integration

Titan supports multiple AI connections:

Direct Provider: Anthropic, OpenAI, Gemini
LLM Gateway: OpenAI-compatible endpoints such as LiteLLM

Configure during first setup or later via the TUI settings.

📚 Documentation

Contributing: See DEVELOPMENT.md
AI Agent Guide: See CLAUDE.md
Release History: See GitHub Releases

🤝 Contributing

Contributions are welcome! See DEVELOPMENT.md for:

Development setup
Code style guidelines
Testing requirements
Architecture overview

📄 License

MIT License - see LICENSE for details

🙏 Acknowledgments

Built with:

Typer - CLI framework
Textual - Terminal UI framework
Pydantic - Data validation
Poetry - Dependency management

Metadata

Release files for titan-cli 0.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for titan-cli 0.10.0
File	Size	Uploaded
titan_cli-0.10.0.tar.gz	664.9 kB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for titan-cli 0.10.0
File	Interpreter	ABI	Platform	Reset
titan_cli-0.10.0-py3-none-any.whl 913.5 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 1.6 MB

Release files / titan_cli-0.10.0.tar.gz

Download URL	titan_cli-0.10.0.tar.gz
Size	664.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`956e45b7aea9fdc0b578599e183f95f0e89ccfd8eace65f2d6a4644f3fdd94a7`
BLAKE2b-256 checksum How to use checksums	`9fc8461c4c2e439e30b6fd02286b22dc697a1ea48866a1f006a69ccdc06d138e`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.12.3 Linux/6.8.0-142-generic`

Release files / titan_cli-0.10.0-py3-none-any.whl

Download URL	titan_cli-0.10.0-py3-none-any.whl
Size	913.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`dfd4b11c4e923a5aba87572133316ddce64c1563ad9c500026f2449aa389fba6`
BLAKE2b-256 checksum How to use checksums	`3e67b1b7b756b3e363395c626f381499428ff3661cfa9ee69a5ddc448c3319e3`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.12.3 Linux/6.8.0-142-generic`