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.9.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.9.0
File	Size	Uploaded
titan_cli-0.9.0.tar.gz	606.8 kB	Sep 10, 2026	Details

Built distribution (wheel)

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

Total release size: 1.5 MB

Release files / titan_cli-0.9.0.tar.gz

Download URL	titan_cli-0.9.0.tar.gz
Size	606.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`a0cced05d3d6e434da581034992c723c32b03ab351242162ec2e279b9f378306`
BLAKE2b-256 checksum How to use checksums	`9f35d84367c0956c47493f679cf34244dc56c161954e87db4230049c1fbab898`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.12.3 Linux/6.8.0-139-generic`

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

Download URL	titan_cli-0.9.0-py3-none-any.whl
Size	850.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b410960642fe7d8cd31a7d93f688065011f03ec15cc7d8d1cb78e242325771c3`
BLAKE2b-256 checksum How to use checksums	`51f1ebc623808ad4ae4173410ea292e181b6e0c86f884321a253812010595880`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.2.1 CPython/3.12.3 Linux/6.8.0-139-generic`