Metadata-Version: 2.4
Name: titan-cli
Version: 0.4.4
Summary: Modular development tools orchestrator - Streamline your workflows with AI integration and intuitive terminal UI
License: MIT
License-File: LICENSE
Keywords: cli,workflow,orchestrator,automation,devtools,ai
Author: MasOrange Apps Team
Author-email: apps-management-stores@masorange.es
Requires-Python: >=3.10,<4.0.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: anthropic (>=0.75.0,<0.76.0)
Requires-Dist: google-auth (>=2.43.0,<3.0.0)
Requires-Dist: google-genai (>=1.58.0,<2.0.0)
Requires-Dist: h2 (>=4.1.0,<5.0.0)
Requires-Dist: jinja2 (>=3.1.4,<4.0.0)
Requires-Dist: keyring (>=25.7.0,<26.0.0)
Requires-Dist: openai (>=2.0.0,<3.0.0)
Requires-Dist: packaging (>=23.0,<25.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: python-dotenv (>=1.2.1,<2.0.0)
Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: structlog (>=25.5.0,<26.0.0)
Requires-Dist: textual (>=1.0.0,<2.0.0)
Requires-Dist: tomli (>=2.0.0,<3.0.0)
Requires-Dist: tomli-w (>=1.0.0,<2.0.0)
Requires-Dist: typer (>=0.20.0,<1.0.0)
Project-URL: Documentation, https://masorange.github.io/titan-cli/
Project-URL: Homepage, https://github.com/masorange/titan-cli
Project-URL: Repository, https://github.com/masorange/titan-cli
Description-Content-Type: text/markdown

# 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)

```bash
# 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](DEVELOPMENT.md) for complete development setup.**

Quick start:
```bash
# 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

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

On first run, Titan will guide you through:
1. **Global Setup** - Configure AI connections (optional)
2. **Project Setup** - Enable plugins and configure project settings

### Basic Usage

```bash
# 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](DEVELOPMENT.md)
- **AI Agent Guide**: See [CLAUDE.md](CLAUDE.md)
- **Release History**: See [GitHub Releases](https://github.com/masorange/titan-cli/releases)

## 🤝 Contributing

Contributions are welcome! See [DEVELOPMENT.md](DEVELOPMENT.md) for:
- Development setup
- Code style guidelines
- Testing requirements
- Architecture overview

## 📄 License

MIT License - see [LICENSE](LICENSE) for details

## 🙏 Acknowledgments

Built with:
- [Typer](https://typer.tiangolo.com/) - CLI framework
- [Textual](https://textual.textualize.io/) - Terminal UI framework
- [Pydantic](https://docs.pydantic.dev/) - Data validation
- [Poetry](https://python-poetry.org/) - Dependency management

