inframate 0.1.0__tar.gz

inframate-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: inframate
+Version: 0.1.0
+Summary: An all-in-one local interface for navigating, operating, and understanding your Terraform infrastructure
+Author: Amin Dorostanian
+License-Expression: AGPL-3.0-only
+Project-URL: Homepage, https://github.com/neuroship/inframate
+Project-URL: Repository, https://github.com/neuroship/inframate
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: FastAPI
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi[standard]>=0.115.0
+Requires-Dist: python-hcl2>=5.0
+Requires-Dist: openai>=1.50
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: aioboto3>=15.5.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=15.0.0
+Requires-Dist: textual>=8.2.3
+
+# inframate
+
+A CLI tool for managing Terraform infrastructure. Browse resources, apply changes, detect drift, view costs, and fix errors with AI — all from your terminal.
+
+## Install
+
+```bash
+# uv (recommended)
+uv tool install inframate
+
+# Homebrew
+brew install inframate
+
+# pip / pipx
+pip install inframate
+```
+
+## Usage
+
+```bash
+cd my-terraform-project
+inframate                # interactive resource browser (TUI)
+inframate --no-cloud     # skip AWS cloud scan (faster)
+inframate --service s3   # filter by service
+inframate --json         # output as JSON
+inframate serve             # start web UI at http://localhost:8000
+```
+
+Running `inframate` in a Terraform project directory will:
+
+1. Read the Terraform graph and plan
+2. Scan AWS resources for drift and unmanaged resources
+3. Open an interactive TUI for browsing, applying, and destroying resources
+4. If the plan fails and AI is configured, offer AI-assisted diagnosis and fixes
+
+### Resource statuses
+
+| Status | Meaning |
+|--------|---------|
+| **Managed** | In Terraform state and code, no pending changes |
+| **Pending** | In code but not yet applied (create/update/destroy/replace planned) |
+| **Drift** | Applied but actual cloud state differs from Terraform state |
+| **Unmanaged** | Exists in AWS but not in any Terraform configuration |
+| **Orphaned** | In Terraform state but the resource no longer exists in cloud |
+
+Each resource also shows three indicators: **S** (in state), **C** (in code), **W** (in cloud).
+
+### TUI keybindings
+
+**Navigation & search**
+
+| Key | Action |
+|-----|--------|
+| `Up/Down` | Navigate resources |
+| `Left/Right` | Collapse/expand tree node |
+| `/` | Search resources by name, type, or service |
+| `Escape` | Clear search |
+| `e` | Expand all tree nodes |
+| `c` | Collapse all tree nodes |
+
+**Filters**
+
+| Key | Action |
+|-----|--------|
+| `a` | Show all resources |
+| `m` | Filter: managed |
+| `p` | Filter: pending |
+| `d` | Filter: drift |
+| `u` | Filter: unmanaged |
+| `o` | Filter: orphaned |
+| `1` | Filter action: create |
+| `2` | Filter action: update |
+| `3` | Filter action: destroy |
+| `4` | Filter action: replace |
+| `0` | Clear action filter |
+
+**Actions**
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Show resource detail (attributes, changes, tags) |
+| `Space` | Toggle resource selection |
+| `r` | Apply (all planned changes, or selected only) |
+| `x` | Destroy selected resources |
+| `$` | Load and display AWS costs |
+| `F5` | Refresh (re-read terraform + cloud data) |
+| `q` | Quit |
+
+When apply or destroy fails, inframate streams AI diagnosis, suggests file changes and commands (e.g. `terraform import`, `terraform state rm`), and offers to apply fixes — in a loop until the issue is resolved.
+
+## Configuration
+
+Config is stored in `~/.inframate/config.yml` (created on first run). Project-level `.inframate.yml` overrides global settings.
+
+```yaml
+ai:
+  provider: openai   # openai | anthropic | ollama | groq | deepseek
+  api_token: sk-...
+  # model: gpt-4o   # optional, defaults per provider
+
+# Or use a custom endpoint:
+# ai:
+#   endpoint: http://localhost:11434/v1
+#   api_token: ollama
+#   model: llama3
+```
+
+Provider defaults:
+
+| Provider | Endpoint | Default model |
+|----------|----------|---------------|
+| `openai` | `api.openai.com/v1` | `gpt-4o` |
+| `anthropic` | `api.anthropic.com/v1` | `claude-sonnet-4-20250514` |
+| `ollama` | `localhost:11434/v1` | `llama3` |
+| `groq` | `api.groq.com/openai/v1` | `llama-3.3-70b-versatile` |
+| `deepseek` | `api.deepseek.com/v1` | `deepseek-chat` |
+
+Environment variables (`OPENAI_API_KEY`, `OPENAI_API_BASE`, `OPENAI_MODEL`) also work and take precedence over the config file.
+
+## Web UI
+
+```bash
+inframate serve
+inframate serve --port 9000
+inframate serve --no-browser
+```
+
+The web UI provides a browser-based interface with file editing, AI chat sidebar, and interactive resource management.
+
+## Development
+
+### Prerequisites
+
+- [go-task](https://taskfile.dev/)
+- [Python 3.13+](https://www.python.org/)
+- [uv](https://docs.astral.sh/uv/)
+- [Node.js 22+](https://nodejs.org/)
+- [Terraform](https://www.terraform.io/)
+
+### Setup
+
+```bash
+task install       # install all dependencies
+task api:dev       # start API server (terminal 1)
+task ui:dev        # start UI dev server (terminal 2)
+```
+
+### Build
+
+```bash
+task build         # build UI + Python package
+task run           # run the built CLI
+```
+
+## Project structure
+
+```
+services/
+  api/    Python 3.13 / FastAPI backend
+  ui/     Svelte 5 / TailwindCSS frontend
+```

inframate-0.1.0/README.md

@@ -0,0 +1,161 @@
+# inframate
+
+A CLI tool for managing Terraform infrastructure. Browse resources, apply changes, detect drift, view costs, and fix errors with AI — all from your terminal.
+
+## Install
+
+```bash
+# uv (recommended)
+uv tool install inframate
+
+# Homebrew
+brew install inframate
+
+# pip / pipx
+pip install inframate
+```
+
+## Usage
+
+```bash
+cd my-terraform-project
+inframate                # interactive resource browser (TUI)
+inframate --no-cloud     # skip AWS cloud scan (faster)
+inframate --service s3   # filter by service
+inframate --json         # output as JSON
+inframate serve             # start web UI at http://localhost:8000
+```
+
+Running `inframate` in a Terraform project directory will:
+
+1. Read the Terraform graph and plan
+2. Scan AWS resources for drift and unmanaged resources
+3. Open an interactive TUI for browsing, applying, and destroying resources
+4. If the plan fails and AI is configured, offer AI-assisted diagnosis and fixes
+
+### Resource statuses
+
+| Status | Meaning |
+|--------|---------|
+| **Managed** | In Terraform state and code, no pending changes |
+| **Pending** | In code but not yet applied (create/update/destroy/replace planned) |
+| **Drift** | Applied but actual cloud state differs from Terraform state |
+| **Unmanaged** | Exists in AWS but not in any Terraform configuration |
+| **Orphaned** | In Terraform state but the resource no longer exists in cloud |
+
+Each resource also shows three indicators: **S** (in state), **C** (in code), **W** (in cloud).
+
+### TUI keybindings
+
+**Navigation & search**
+
+| Key | Action |
+|-----|--------|
+| `Up/Down` | Navigate resources |
+| `Left/Right` | Collapse/expand tree node |
+| `/` | Search resources by name, type, or service |
+| `Escape` | Clear search |
+| `e` | Expand all tree nodes |
+| `c` | Collapse all tree nodes |
+
+**Filters**
+
+| Key | Action |
+|-----|--------|
+| `a` | Show all resources |
+| `m` | Filter: managed |
+| `p` | Filter: pending |
+| `d` | Filter: drift |
+| `u` | Filter: unmanaged |
+| `o` | Filter: orphaned |
+| `1` | Filter action: create |
+| `2` | Filter action: update |
+| `3` | Filter action: destroy |
+| `4` | Filter action: replace |
+| `0` | Clear action filter |
+
+**Actions**
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Show resource detail (attributes, changes, tags) |
+| `Space` | Toggle resource selection |
+| `r` | Apply (all planned changes, or selected only) |
+| `x` | Destroy selected resources |
+| `$` | Load and display AWS costs |
+| `F5` | Refresh (re-read terraform + cloud data) |
+| `q` | Quit |
+
+When apply or destroy fails, inframate streams AI diagnosis, suggests file changes and commands (e.g. `terraform import`, `terraform state rm`), and offers to apply fixes — in a loop until the issue is resolved.
+
+## Configuration
+
+Config is stored in `~/.inframate/config.yml` (created on first run). Project-level `.inframate.yml` overrides global settings.
+
+```yaml
+ai:
+  provider: openai   # openai | anthropic | ollama | groq | deepseek
+  api_token: sk-...
+  # model: gpt-4o   # optional, defaults per provider
+
+# Or use a custom endpoint:
+# ai:
+#   endpoint: http://localhost:11434/v1
+#   api_token: ollama
+#   model: llama3
+```
+
+Provider defaults:
+
+| Provider | Endpoint | Default model |
+|----------|----------|---------------|
+| `openai` | `api.openai.com/v1` | `gpt-4o` |
+| `anthropic` | `api.anthropic.com/v1` | `claude-sonnet-4-20250514` |
+| `ollama` | `localhost:11434/v1` | `llama3` |
+| `groq` | `api.groq.com/openai/v1` | `llama-3.3-70b-versatile` |
+| `deepseek` | `api.deepseek.com/v1` | `deepseek-chat` |
+
+Environment variables (`OPENAI_API_KEY`, `OPENAI_API_BASE`, `OPENAI_MODEL`) also work and take precedence over the config file.
+
+## Web UI
+
+```bash
+inframate serve
+inframate serve --port 9000
+inframate serve --no-browser
+```
+
+The web UI provides a browser-based interface with file editing, AI chat sidebar, and interactive resource management.
+
+## Development
+
+### Prerequisites
+
+- [go-task](https://taskfile.dev/)
+- [Python 3.13+](https://www.python.org/)
+- [uv](https://docs.astral.sh/uv/)
+- [Node.js 22+](https://nodejs.org/)
+- [Terraform](https://www.terraform.io/)
+
+### Setup
+
+```bash
+task install       # install all dependencies
+task api:dev       # start API server (terminal 1)
+task ui:dev        # start UI dev server (terminal 2)
+```
+
+### Build
+
+```bash
+task build         # build UI + Python package
+task run           # run the built CLI
+```
+
+## Project structure
+
+```
+services/
+  api/    Python 3.13 / FastAPI backend
+  ui/     Svelte 5 / TailwindCSS frontend
+```

inframate-0.1.0/app/cli.py

@@ -0,0 +1,81 @@
+import argparse
+import os
+
+
+def _check_tf_files(project_dir: str):
+    has_tf = any(f.endswith(".tf") for f in os.listdir(project_dir) if os.path.isfile(os.path.join(project_dir, f)))
+    if not has_tf:
+        print(f"No .tf files found in {project_dir}")
+        print()
+        print("To get started, create a terraform configuration or run:")
+        print(f"  cd {project_dir} && terraform init")
+        raise SystemExit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="inframate",
+        description="Terraform infrastructure management tool. Runs the interactive resource browser by default.",
+    )
+    parser.add_argument("--dir", type=str, default=".", help="Terraform project directory (default: cwd)")
+    parser.add_argument("--service", type=str, default=None, help="Filter by service name")
+    parser.add_argument("--no-cloud", action="store_true", help="Skip cloud scan (faster, no drift/unmanaged detection)")
+    parser.add_argument("--status", type=str, default=None, choices=["managed", "pending", "drift", "unmanaged", "orphaned"], help="Filter by status (for --json)")
+    parser.add_argument("--json", action="store_true", dest="json_output", help="Output as JSON (non-interactive)")
+
+    sub = parser.add_subparsers(dest="command")
+
+    ui_parser = sub.add_parser("serve", help="Start web server with UI")
+    ui_parser.add_argument("--port", type=int, default=None, help="Port (default: from config or 8000)")
+    ui_parser.add_argument("--no-browser", action="store_true", help="Don't open browser on startup")
+
+    args = parser.parse_args()
+
+    project_dir = os.path.abspath(args.dir)
+    if not os.path.isdir(project_dir):
+        print(f"Error: {project_dir} is not a directory")
+        raise SystemExit(1)
+
+    # Version check (background)
+    from app.services.version_check import start_check, print_update_notice
+    version_thread = start_check()
+
+    # Load config
+    from app import config
+    overrides = {}
+    if hasattr(args, "port") and args.port is not None:
+        overrides["port"] = args.port
+    config.init_config_dir()
+    config.load_config(project_dir, overrides)
+
+    _check_tf_files(project_dir)
+
+    # Backend reachability check (skip for ui)
+    credential_expiry = None
+    if args.command != "serve":
+        from app.services.backend_check import check_backend, get_credential_expiry
+        ok, errors = check_backend(project_dir)
+        if not ok:
+            print("Backend authentication failed:\n")
+            for err in errors:
+                print(f"  - {err}")
+            print()
+            raise SystemExit(1)
+        credential_expiry = get_credential_expiry()
+
+    # Dispatch
+    try:
+        if args.command == "serve":
+            from app.cli_commands.ui import run_ui
+            run_ui(project_dir, config.get_port(), args.no_browser)
+        else:
+            from app.cli_commands.resources import run_resources
+            run_resources(project_dir, status=args.status, service=args.service, json_output=args.json_output, no_cloud=args.no_cloud, credential_expiry=credential_expiry)
+    except KeyboardInterrupt:
+        print()
+
+    print_update_notice(version_thread)
+
+
+if __name__ == "__main__":
+    main()

inframate-0.1.0/app/cli_commands/console.py

@@ -0,0 +1,17 @@
+"""Shared rich console for CLI commands."""
+
+from rich.console import Console
+from rich.theme import Theme
+
+theme = Theme({
+    "info": "cyan",
+    "success": "green",
+    "warning": "yellow",
+    "error": "red bold",
+    "muted": "dim",
+    "cost.high": "red bold",
+    "cost.medium": "yellow",
+    "cost.low": "green",
+})
+
+console = Console(theme=theme)