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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

titan_cli-0.8.0.tar.gz (584.2 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

titan_cli-0.8.0-py3-none-any.whl (821.1 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file titan_cli-0.8.0.tar.gz.

File metadata

Download URL: titan_cli-0.8.0.tar.gz
Upload date: Aug 26, 2026
Size: 584.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.2.1 CPython/3.12.3 Linux/6.8.0-137-generic

File hashes

Hashes for titan_cli-0.8.0.tar.gz
Algorithm	Hash digest
SHA256	`0bdabb38e694e91be49c9c949579795c165be2f38c219fd90134f9611fea36ea`
MD5	`2353af871b7abdf9d62141e29834469c`
BLAKE2b-256	`29c4d8fb2c0b16e311ff7f33debb2510afb9de1a118bd8deb2de50a58d68ac8c`

See more details on using hashes here.

File details

Details for the file titan_cli-0.8.0-py3-none-any.whl.

File metadata

Download URL: titan_cli-0.8.0-py3-none-any.whl
Upload date: Aug 26, 2026
Size: 821.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/2.2.1 CPython/3.12.3 Linux/6.8.0-137-generic

File hashes

Hashes for titan_cli-0.8.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`f722484c1545eb7a0e597eba1137c706a7940831468b946578780d053dc2114d`
MD5	`a2925fe55eadc1831915131c12a5f71d`
BLAKE2b-256	`21f5fd5a9d427ab9ce4997a77c7743d8862f95655f88ca5f64444de23836469c`