{"id":34724809,"url":"https://github.com/thothforge/thothctl","last_synced_at":"2026-03-17T22:15:37.166Z","repository":{"id":280035159,"uuid":"929563802","full_name":"thothforge/thothctl","owner":"thothforge","description":"A command line interface tool designed for efficient management and automation within your internal developer platform.","archived":false,"fork":false,"pushed_at":"2026-03-14T23:52:08.000Z","size":27880,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-15T08:34:18.762Z","etag":null,"topics":["devops-tools","devsecops","framework","iac","internal-development","platform-engineering","python","template"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thothforge.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-08T20:50:59.000Z","updated_at":"2026-03-14T23:52:11.000Z","dependencies_parsed_at":"2025-02-28T23:42:17.461Z","dependency_job_id":"3f983b1a-d144-4769-8f3e-c2020112cb68","html_url":"https://github.com/thothforge/thothctl","commit_stats":null,"previous_names":["thothforge/thothctl"],"tags_count":88,"template":false,"template_full_name":null,"purl":"pkg:github/thothforge/thothctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thothforge%2Fthothctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thothforge%2Fthothctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thothforge%2Fthothctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thothforge%2Fthothctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thothforge","download_url":"https://codeload.github.com/thothforge/thothctl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thothforge%2Fthothctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30633243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["devops-tools","devsecops","framework","iac","internal-development","platform-engineering","python","template"],"created_at":"2025-12-25T02:21:47.091Z","updated_at":"2026-03-17T22:15:37.136Z","avatar_url":"https://github.com/thothforge.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Publish Python Package](https://github.com/thothforge/thothctl/actions/workflows/python-publish.yml/badge.svg)](https://github.com/thothforge/thothctl/actions/workflows/python-publish.yml)\n# Thoth Framework\n\n![ThothCTL MCP](./docs/img/framework/thothctl_mcp.png)\n\nThoth Framework is a framework to create and manage the [Internal Developer Platform](https://internaldeveloperplatform.org/what-is-an-internal-developer-platform/) tasks for infrastructure, devops, devsecops, software developers, and platform engineering teams aligned with the business objectives:\n\n1. [x] Minimize mistakes.\n2. [x] Increase velocity\n3. [x] Improve products\n4. [x] Enforce compliance\n5. [x] Reduce lock-in\n\n## Mapping Mechanisms \n| Business Objective | Mechanism          | Implementation |\n|-------------------|--------------------|----------------|\n| Minimize mistakes | Meaninful defaults | Templates      |\n| Increase velocity | Automation         | IaC Scripts    |\n| Improve products | Fill product gaps  | New components |\n| Enforce compliance | Restrict choinces  | Wrappers       |\n| Reduce lock-in | Abstraction        | Service layers |\n\nThoth allows you to extend and operate your Developer Control Plane, and enable the developer experience with the internal developer platform trough command line.\n\n![Thoth and DCP ](./docs/img/framework/thothfr.png)\n\n# Tools\n\n## ThothCTL\n\nPackage for accelerating the adoption of Internal Frameworks, enable reusing and interaction with the Internal Developer Platform. \n\n# Use cases\n- **[Template Engine](template_engine/template_engine.md)**:\n  - Build and configure any kind of template\n  - Handling templates to create, add, remove or update components\n  - Code generation\n  \n- **Automate tasks**:\n  - Create and bootstrap local development environment\n  - Extend CI/CD pull request workflow\n  - Create documentation for projects (IaC), Generative AI doc generation\n\n- **Check and compliance**:\n  - Check project structure\n    - DevSecOps for IaC (Terraform, tofu)\n      - Scan your IaC terraform,tofu templates\n      - Generate reports \n      - Manage inventory and dependencies\n      - Review IaC changes and make suggestions (Generative AI)\n      - **AWS Cost Analysis** - Estimate infrastructure costs from Terraform plans\n        - Offline pricing estimates (regularly updated)\n        - Service-by-service cost breakdown\n        - Optimization recommendations\n        - Support for 14 AWS services (EC2, RDS, S3, Lambda, EKS, ECS, etc.)\n      \n- **Internal Developer Platform CLI**\n  - Create projects from your templates\n  - Source control setup\n  - Scaffold - quickly set up the structure of a project.\n  \n\n\n# Getting Started\n\n```bash\n$ thothctl --help\nUsage: thothctl [OPTIONS] COMMAND [ARGS]...\n\n  ThothForge CLI - The Internal Developer Platform CLI\n\nOptions:\n  --version                  Show the version and exit.\n  --debug                    Enable debug mode\n  -d, --code-directory PATH  Configuration file path\n  --help                     Show this message and exit.\n\nCommands:\n  check      Initialize and setup project configurations\n  document   Initialize and setup project configurations\n  generate   Generate IaC from rules, use cases, and components\n  init       Initialize and setup project configurations\n  inventory  Create Inventory for the iac composition.\n  list       List Projects and Spaces managed by thothctl locally\n  mcp        Model Context Protocol (MCP) server for ThothCTL\n  project    Convert, clean up and manage the current project\n  remove     Remove Projects manage by thothctl\n  scan       Scan infrastructure code for security issues.\n  upgrade    Upgrade thothctl to the latest version\n\n## 💰 AWS Cost Analysis\n\nThothCTL includes comprehensive AWS cost analysis capabilities:\n\n```bash\n# Analyze Terraform plan costs\nthothctl check iac -type cost-analysis --recursive\n\n# Features:\n# ✅ 14 AWS services supported (EC2, RDS, S3, Lambda, EKS, ECS, etc.)\n# ✅ Monthly/annual cost projections\n# ✅ Service-by-service breakdown\n# ✅ Optimization recommendations\n# ✅ No AWS credentials required\n# ✅ Works offline\n```\n\n**Supported Services**: EC2, RDS, S3, Lambda, ELB/ALB/NLB, VPC, EBS, DynamoDB, CloudWatch, EKS, ECS, Secrets Manager, API Gateway, Bedrock\n\n```\n\n## Enabling Command Autocompletion\n\nThothCTL supports command autocompletion to make it easier to use. To enable it:\n\n```bash\n# Install the package\npip install thothctl\n\n# Run the autocomplete setup script\nthothctl-register-autocomplete\n\n# Follow the instructions to add the autocomplete configuration to your shell\n```\n\nAfter setting up autocomplete, you can use the Tab key to complete commands, options, and arguments.\n\nFor example, you can type `thothctl i\u003cTAB\u003e` and it will expand to `thothctl init`.\n\n## 🎯 Recent Improvements - Inventory Command\n\n### **Modern Infrastructure Inventory with Professional Reports** ✨\n\nThe `thothctl inventory iac` command has been significantly enhanced with:\n\n#### **🎨 Modern HTML Reports**\n- **Professional styling** with Inter font and gradient design\n- **Responsive layout** that works on desktop, tablet, and mobile\n- **Color-coded status badges** for easy identification of outdated components\n- **Print optimization** perfect for documentation and sharing\n\n#### **🚀 Unified Version Checking**\n```bash\n# Before: Confusing multiple flags\nthothctl inventory iac --check-providers --check-provider-versions --check-versions\n\n# After: Simple and intuitive\nthothctl inventory iac --check-versions\n```\n\n#### **📊 Enhanced Provider Analysis**\n- **Provider version columns** showing \"Latest Version\" and \"Status\"\n- **Comprehensive provider tracking** with registry information\n- **Automatic provider checking** when version analysis is enabled\n- **Provider statistics** in summary reports\n\n#### **Quick Start**\n```bash\n# Create comprehensive inventory with modern reporting\nthothctl inventory iac --check-versions\n\n# Generate professional documentation\nthothctl inventory iac --check-versions --project-name \"Production Infrastructure\"\n\n# CI/CD integration with JSON output\nthothctl inventory iac --check-versions --report-type json\n```\n\n**Benefits:**\n- ✅ **50% reduction** in command complexity\n- ✅ **Professional reports** suitable for business presentations\n- ✅ **Enhanced provider analysis** with version tracking\n- ✅ **Simplified user experience** with intelligent automation\n\n## Third Party Tools\n\n### [OpenTofu](https://opentofu.org/)\nOpenTofu is a fork of Terraform that is open-source, community-driven, and managed by the Linux Foundation.\n\n### [Backstage](https://backstage.io/)\nAn open source framework for building developer portals.\n\n### [Terragrunt](https://terragrunt.gruntwork.io/)\nTerragrunt is a flexible orchestration tool that allows Infrastructure as Code to scale. \n\n### [Terraform-docs](https://terraform-docs.io/)\nGenerate Terraform modules documentation in various formats.\n\n### [Checkov](https://www.checkov.io/)\nCheckov scans cloud infrastructure configurations to find misconfigurations before they're deployed.\n\n### [KICS](https://docs.kics.io/latest/)\nKICS (Keeping Infrastructure as Code Secure) by Checkmarx finds security vulnerabilities, compliance issues, and infrastructure misconfigurations in IaC.\n\n**Requirements**: Docker must be installed and running to use KICS scanner.\n- Install Docker: https://docs.docker.com/get-docker/\n- KICS runs via Docker container (checkmarx/kics:latest)\n\n### [Trivy](https://trivy.dev/latest/)\nUse Trivy to find vulnerabilities (CVE) \u0026 misconfigurations (IaC) across code repositories, binary artifacts, container images, Kubernetes clusters, and more. All in one tool! \n\n# Requirements\n - Linux Environment or Windows environment\n\n\u003e This documentation uses wsl with ubuntu 24.04 but you can use other superior version\n\n## OS Packages\n\n- dot or graphviz\n\nYou can install them with:\n\n### Windows\n Chocolatey packages Graphviz for **Windows**.\n\n`choco install graphviz`\n### Linux\nInstall packages with apt for Linux/Debian\n- \n```bash \nsudo apt install graphviz -y\n```\n- python \u003e= 3.8 \n    - check: `python --version` \n\n### AddOns\n\nIf you are going to send messages to Microsoft Teams channel you must set an environment variable with name `webhook`\n\u003e Visit [Webhooks and connectors](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/what-are-webhooks-and-connectors) for more.\n\n### Python packages\n\nThere are many dependencies for thothctl functions, these dependencies are automatically installed when run `pip install` command.\n\n\n# Install\n\n```Bash\npip install --upgrade thothctl\n```\n\n## Version control Systems (Azure DevOps, Github, Gitlab)\n\n# RoadMap 🧗‍♂\n\n - Add Autocomplete to Commands and subcommands\n - Integrate MCP to improve compatibility and interoperability with AI LLM\n - Improve Inventory capabilities\n - Create Stacks and Infrastructure composition engine\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthothforge%2Fthothctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthothforge%2Fthothctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthothforge%2Fthothctl/lists"}