# Introduction

Welcome to **Localargo**! A convenient command-line tool designed specifically for ArgoCD local development workflows.

## What is Localargo?

Localargo is a comprehensive CLI tool that makes ArgoCD development faster and more convenient. It provides streamlined commands for all aspects of local ArgoCD development, from cluster setup to application debugging.

## Key Features

- 🚀 **Cluster Management**: Easy setup and switching between local/remote Kubernetes clusters
- 📦 **Application Lifecycle**: Create, sync, and manage ArgoCD applications with simple commands
- 🌐 **Port Forwarding**: One-command access to services running in your applications
- 🔐 **Secrets Management**: Create and manage secrets for local development environments
- 🔄 **Smart Syncing**: Sync applications with watch mode for continuous development
- 📋 **Application Templates**: Quick-start new projects from common application templates
- 🔍 **Debug Tools**: Comprehensive debugging utilities for troubleshooting issues

## Who is This For?

Localargo is designed for:

- **Developers** working with ArgoCD in local environments
- **DevOps Engineers** managing multiple ArgoCD applications
- **Platform Teams** providing ArgoCD development workflows
- **Anyone** doing GitOps development with ArgoCD

## Technology Stack

Built with modern Python tooling:

- **Hatch**: Project management and building
- **Click**: Intuitive command-line interfaces
- **PyYAML**: Configuration and manifest handling
- **MyPy**: Static type checking
- **Coverage**: Test coverage reporting

## Project Status

Localargo is in **active development** with a focus on developer experience and comprehensive ArgoCD workflow support.

## Getting Started

Ready to get started? Check out the [Installation](installation.md) and [Usage](usage.md) guides.

## Getting Help

Need help or want to contribute?

- 📖 [Documentation](https://github.com/William Born/localargo#readme)
- 🐛 [Report Issues](https://github.com/William Born/localargo/issues)
- 💻 [Source Code](https://github.com/William Born/localargo)
- 💬 [Discussions](https://github.com/William Born/localargo/discussions)
