Initial commit: CodeRun CLI application

- Complete Go CLI application built with Cobra framework
- Container-as-a-Service interface for Kubernetes deployments
- Commands: login, deploy, list, status, delete, logs
- HTTP API client with authentication support
- Configuration management with secure token storage
- Environment variable parsing and resource validation
- Comprehensive .gitignore to exclude sensitive files
- Translated all Spanish comments to English
- Safe example.env without actual API key patterns

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: barckcode

.gitignore

@@ -0,0 +1,45 @@
+# Binaries
+coderun
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool
+*.out
+
+# Go workspace file
+go.work
+go.work.sum
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Configuration files with credentials
+config.json
+.env
+*.env
+!example.env
+
+# User config directory
+.coderun/
+
+# Logs
+*.log

CLAUDE.md

@@ -0,0 +1,61 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+### Build
+```bash
+go build -o coderun .
+```
+
+### Run Tests
+```bash
+go test ./...
+```
+
+### Install Binary (Optional)
+```bash
+sudo mv coderun /usr/local/bin/
+```
+
+## Project Architecture
+
+This is a Go CLI application built with Cobra that provides a Container-as-a-Service interface for deploying Docker containers to Kubernetes. The application consists of:
+
+### Core Structure
+- **`main.go`**: Entry point that calls `cmd.Execute()`
+- **`cmd/`**: Contains all CLI commands using Cobra framework
+  - `root.go`: Base command definition and configuration
+  - `login.go`, `deploy.go`, `list.go`, `status.go`, `delete.go`, `logs.go`: Individual command implementations
+- **`internal/client/`**: HTTP API client implementation
+  - `client.go`: Core HTTP client with authentication
+  - `auth.go`, `deployments.go`: API endpoint implementations
+  - `types.go`: Request/response type definitions
+- **`internal/utils/`**: Utility functions
+  - `config.go`: Configuration file management (~/.coderun/config.json)
+  - `env.go`: Environment file parsing and resource validation
+
+### Key Design Patterns
+- Uses Cobra for CLI structure with subcommands
+- HTTP client with bearer token authentication
+- Configuration stored in `~/.coderun/config.json` with access tokens
+- Environment variables loaded from files using `KEY=VALUE` format
+- Resource validation for CPU (e.g., `100m`, `0.5`) and memory (e.g., `128Mi`, `1Gi`)
+- Long timeout (10 minutes) for deployment operations
+
+### API Integration
+- Communicates with CodeRun API (default: `http://localhost:8000`)
+- Supports custom API URL via `--api-url` flag or `CODERUN_API_URL` environment variable
+- Handles deployment creation, listing, status checking, and deletion
+- Supports container resource limits, replicas, HTTP port exposure, and environment variables
+
+### Commands Available
+- `coderun login`: Authenticate and store access token
+- `coderun deploy IMAGE`: Deploy containers with optional flags for replicas, resources, ports, env files
+- `coderun list`: List all deployments in table format
+- `coderun status APP_NAME`: Get detailed deployment status
+- `coderun delete DEPLOYMENT_ID`: Remove deployments
+- `coderun logs DEPLOYMENT_ID`: View container logs
+
+The CLI is designed to be the primary interface for the CodeRun platform, abstracting Kubernetes complexity while providing essential container deployment and management capabilities.

README.md

@@ -0,0 +1,274 @@
+# CodeRun CLI
+
+CodeRun CLI is a command-line tool for deploying and managing Docker containers on the CodeRun platform.
+
+## Installation
+
+### Build from source code
+
+```bash
+git clone <repository-url>
+cd cli
+go build -o coderun .
+```
+
+### Move binary to your PATH (optional)
+
+```bash
+sudo mv coderun /usr/local/bin/
+```
+
+## Configuration
+
+### 1. Login
+
+First you need to authenticate with your CodeRun account:
+
+```bash
+coderun login
+```
+
+You will be prompted for your email and password. The access token will be saved in `~/.coderun/config.json`.
+
+### 2. Configure API URL (optional)
+
+By default, the CLI uses `https://api.coderun.dev`. To use a local instance:
+
+```bash
+coderun --api-url http://localhost:8000 login
+```
+
+Or you can configure the environment variable:
+
+```bash
+export CODERUN_API_URL="http://localhost:8000"
+```
+
+## Available Commands
+
+### `coderun login`
+
+Authenticate with the CodeRun platform.
+
+```bash
+coderun login
+```
+
+### `coderun deploy`
+
+Deploy a Docker container.
+
+#### Basic options:
+
+```bash
+# Simple deployment
+coderun deploy nginx:latest
+
+# With specific replicas
+coderun deploy nginx:latest --replicas=3
+
+# With resource limits
+coderun deploy myapp:v1.0 --cpu=500m --memory=1Gi
+
+# With exposed HTTP port
+coderun deploy myapp:v1.0 --http-port=8080
+```
+
+#### Using environment files:
+
+```bash
+# Load environment variables from file
+coderun deploy myapp:v1.0 --env-file=production.env
+
+# Complete example
+coderun deploy myapp:v1.0 \
+  --replicas=2 \
+  --cpu=200m \
+  --memory=512Mi \
+  --http-port=3000 \
+  --env-file=.env \
+  --name=my-production-app
+```
+
+#### Parameters:
+
+- `--replicas`: Number of replicas (default: 1)
+- `--cpu`: CPU limit (example: `100m`, `0.5`, `1`)
+- `--memory`: Memory limit (example: `128Mi`, `1Gi`, `512Ki`) 
+- `--http-port`: HTTP port to expose
+- `--env-file`: Path to environment variables file
+- `--name`: Application name (optional, auto-generated)
+
+### `coderun list`
+
+List all deployments.
+
+```bash
+coderun list
+```
+
+Example output:
+```
+Found 3 deployment(s):
+
+ID         App Name             Image                          Replicas Status     Created         
+----------  -------------------- ------------------------------ -------- ---------- ----------------
+abc12345..  my-nginx             nginx:latest                   2        Running    2024-01-15 14:30
+def67890..  my-api               mycompany/api:v2.1             1        Running    2024-01-15 13:45
+ghi24680..  my-worker            mycompany/worker:latest        3        Pending    2024-01-15 14:25
+```
+
+### `coderun status`
+
+Get detailed status of a deployment by application name.
+
+```bash
+coderun status my-nginx
+```
+
+### `coderun delete`
+
+Delete a deployment by ID.
+
+```bash
+# Delete by specific ID
+coderun delete abc12345def67890
+
+# Using command combination
+coderun delete $(coderun list | grep my-old-app | awk '{print $1}')
+```
+
+## Environment file format
+
+The environment file must follow the `KEY=VALUE` format:
+
+```bash
+# example.env
+DATABASE_URL=postgresql://user:pass@localhost:5432/db
+API_KEY="secret-key-with-special-chars"
+DEBUG=true
+PORT=8080
+```
+
+### Rules:
+
+- One variable per line
+- Format: `KEY=VALUE`
+- Comments start with `#`
+- Empty lines are ignored
+- Values can be quoted (`"` or `'`)
+- No spaces around the `=`
+
+## Usage examples
+
+### Deploy a simple web application
+
+```bash
+# 1. Login
+coderun login
+
+# 2. Deploy nginx
+coderun deploy nginx:latest --replicas=2 --http-port=80
+
+# 3. Check status
+coderun list
+coderun status nginx
+```
+
+### Deploy an application with database
+
+```bash
+# 1. Create environment file
+cat > production.env << EOF
+DATABASE_URL=postgresql://user:pass@db:5432/myapp
+REDIS_URL=redis://redis:6379
+API_KEY=your-secret-key
+APP_ENV=production
+EOF
+
+# 2. Deploy the application
+coderun deploy mycompany/webapp:v2.0 \
+  --replicas=3 \
+  --cpu=500m \
+  --memory=1Gi \
+  --http-port=8080 \
+  --env-file=production.env \
+  --name=webapp-prod
+
+# 3. Verify deployment
+coderun status webapp-prod
+```
+
+### Deployment management
+
+```bash
+# List all deployments
+coderun list
+
+# View details of specific deployment
+coderun status my-app
+
+# Delete old deployment
+coderun delete abc12345def67890
+```
+
+## Troubleshooting
+
+### Authentication error
+
+```bash
+Error: Authentication failed
+```
+
+**Solution**: Run `coderun login` to authenticate again.
+
+### Connection error
+
+```bash
+Error: Failed to connect to API
+```
+
+**Solution**: Verify API URL with `--api-url` or the `CODERUN_API_URL` environment variable.
+
+### Resource format error
+
+```bash
+Error: Invalid CPU format '1core' (examples: 100m, 0.5, 1)
+```
+
+**Solution**: Use valid formats:
+- CPU: `100m`, `0.5`, `1`, `2`
+- Memory: `128Mi`, `1Gi`, `512Ki`
+
+### Environment file error
+
+```bash
+Error: Invalid format at line 5: INVALID LINE (expected KEY=VALUE)
+```
+
+**Solution**: Verify each line follows the `KEY=VALUE` format.
+
+## Configuration files
+
+- **Config**: `~/.coderun/config.json`
+- **Token**: Stored in configuration file
+
+## Development
+
+### Build
+
+```bash
+go build -o coderun .
+```
+
+### Run tests
+
+```bash
+go test ./...
+```
+
+### Add new commands
+
+1. Create file in `cmd/`
+2. Implement command with Cobra
+3. Register in `cmd/root.go`