titan-cli 0.3.0

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

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 (Claude & Gemini) for commits, PRs, and analysis
• ⚡ 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:

1. Global Setup - Configure AI providers (optional)
2. 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 providers:

• Anthropic Claude (Sonnet, Opus, Haiku)
• Google Gemini (Pro, Flash)

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