{"id":25692627,"url":"https://github.com/0xnu/thales","last_synced_at":"2026-05-04T17:36:25.384Z","repository":{"id":279102353,"uuid":"937561898","full_name":"0xnu/thales","owner":"0xnu","description":"A CLI tool to automatically generate and update README.md files using ISO 639 language codes nomenclature by scanning project codebases.","archived":false,"fork":false,"pushed_at":"2025-11-19T09:31:48.000Z","size":36,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-28T21:30:26.647Z","etag":null,"topics":["cli","code-quality","code-review","linux","macos","performance","security","utility","windows"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xnu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-23T11:20:04.000Z","updated_at":"2025-11-19T09:31:52.000Z","dependencies_parsed_at":"2025-02-23T19:37:21.910Z","dependency_job_id":"4dcaf52d-7157-4aeb-a2a5-6d95ea1c326a","html_url":"https://github.com/0xnu/thales","commit_stats":null,"previous_names":["0xnu/thales"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/0xnu/thales","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xnu%2Fthales","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xnu%2Fthales/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xnu%2Fthales/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xnu%2Fthales/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xnu","download_url":"https://codeload.github.com/0xnu/thales/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xnu%2Fthales/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32618209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"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":["cli","code-quality","code-review","linux","macos","performance","security","utility","windows"],"created_at":"2025-02-24T23:27:56.357Z","updated_at":"2026-05-04T17:36:25.379Z","avatar_url":"https://github.com/0xnu.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"## Thales\n\nA CLI tool to automatically generate and update README.md files using [ISO 639 language codes](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) nomenclature by scanning project codebases. It also performs thorough code reviews, which highlight security vulnerabilities, performance bottlenecks, concurrency issues, and other potential problems.\n\n\u003e Created Thales to solve the inconvenience of manually updating README.md files and ensure code quality through automated reviews as codebases evolve.\n\n### Getting Started\n\nFollow these steps to set up and execute Thales:\n\n1. **Installation**\n\nDownload the latest version of Thales for your operating system from the [releases page](https://github.com/0xnu/thales/releases).\n\nAdd Thales binaries for all OS/architectures and code review outputs to your `.gitignore` file:\n\n```bash\n# Thales Binaries\nthales_*\n*.zip\n\n# Thales Code Review\ncode_reviews/\nreviews/\ncustom_reviews/\n*_review/\n```\n\n2. **Environment Setup**\n\nThales supports multiple LLMs. Set up the API key for your preferred model:\n\nFor Claude (default):\n- Get your API key from [Anthropic's Claude Platform](https://www.merge.dev/blog/anthropic-api-key)\n\nFor OpenAI:\n- Get your API key from the [OpenAI Platform Dashboard](https://www.merge.dev/blog/chatgpt-api-key)\n\nFor Grok-2:\n- Get your API key from [xAI's Developer Portal](https://www.merge.dev/blog/grok-api-key)\n\nFor Mixtral:\n- Get your API key from the [Mistral AI Platform](https://www.merge.dev/blog/mistral-ai-api-key)\n\nConfigure your environment variables with the following command:\n\n```bash\nexport ANTHROPIC_API_KEY=\"enter_claude_api_key\" \u0026\u0026 \\\nexport OPENAI_API_KEY=\"enter_openai_api_key\" \u0026\u0026 \\\nexport GROK_API_KEY=\"enter_grok_api_key\" \u0026\u0026 \\\nexport MIXTRAL_API_KEY=\"enter_mixtral_api_key\"\n```\n\n3. **Usage**\n\nFor MacOS:\n\n```bash\n# Documentation tasks\n./thales_darwin_amd64 --new                          # New README with default settings\n./thales_darwin_amd64 --update --lang es             # Update README in Spanish\n./thales_darwin_amd64 --new --output docs/README.md  # Custom output location\n\n# Code review\n./thales_darwin_amd64 --cb . --llm claude            # Review codebase with Claude\n./thales_darwin_amd64 --sf main.go --llm openai      # Review file with OpenAI\n./thales_darwin_amd64 --cb . --llm grok2             # Review codebase with Grok-2\n./thales_darwin_amd64 --cb . --llm mixtral           # Review codebase with Mixtral\n./thales_darwin_amd64 --cb . --llm claude --focus security        # Security review with Claude\n./thales_darwin_amd64 --cb . --llm openai --focus performance    # Performance review with OpenAI\n./thales_darwin_amd64 --sf main.go --llm claude --severity high  # High-severity with Claude\n./thales_darwin_amd64 --cb . --llm openai --focus all --severity medium  # All areas with OpenAI\n\n# Advanced options\n./thales_darwin_amd64 --list-languages               # List supported languages\n./thales_darwin_amd64 --llm openai                   # Use OpenAI instead of Claude\n./thales_darwin_amd64 --review-output reports        # Custom review output directory\n./thales_darwin_amd64 --cb . --pdf                   # Review codebase with PDF output\n./thales_darwin_amd64 --sf main.go --pdf             # Review single file with PDF output\n./thales_darwin_amd64 --cb . --html                  # Review codebase with HTML output\n./thales_darwin_amd64 --sf main.go --html            # Review single file with HTML output\n```\n\nFor Linux:\n\n```bash\n# Documentation tasks\n./thales_linux_amd64 --new                          # New README\n./thales_linux_amd64 --update --lang pt             # Update in Portuguese\n./thales_linux_amd64 --new --llm openai --lang it   # Use OpenAI, Italian output\n\n# Code review\n./thales_linux_amd64 --cb . --llm claude            # Full review with Claude\n./thales_linux_amd64 --sf src/main.go --llm openai  # Single file with OpenAI\n./thales_linux_amd64 --sf main.go --llm grok2       # Single file with Grok-2\n./thales_linux_amd64 --cb . --llm mixtral           # Full review with Mixtral\n./thales_linux_amd64 --cb . --llm claude --focus security,performance  # Multi-focus with Claude\n./thales_linux_amd64 --sf lib/utils.go --llm openai --severity high   # Critical with OpenAI\n./thales_linux_amd64 --cb . --llm claude --review-output custom_reviews  # Custom dir with Claude\n\n# Advanced options\n./thales_linux_amd64 --list-languages               # Available languages\n./thales_linux_amd64 --llm claude                   # Specify LLM\n./thales_linux_amd64 --cb . --pdf                   # Review codebase with PDF output\n./thales_linux_amd64 --sf main.go --pdf             # Review single file with PDF output\n./thales_linux_amd64 --cb . --html                  # Review codebase with HTML output\n./thales_linux_amd64 --sf main.go --html            # Review single file with HTML output\n```\n\nFor Windows:\n\n```bash\n# Documentation tasks\n.\\thales_windows_amd64.exe --new                    # Generate README\n.\\thales_windows_amd64.exe --update --lang zh       # Update in Chinese\n.\\thales_windows_amd64.exe --new --output docs\\README.md  # Custom location\n\n# Code review\n.\\thales_windows_amd64.exe --cb . --llm claude      # Review with Claude\n.\\thales_windows_amd64.exe --sf main.go --llm openai # Review with OpenAI\n.\\thales_windows_amd64.exe --cb . --llm grok2       # Review with Grok-2\n.\\thales_windows_amd64.exe --cb . --llm mixtral     # Review with Mixtral\n.\\thales_windows_amd64.exe --cb . --llm claude --focus security  # Security with Claude\n.\\thales_windows_amd64.exe --sf app.go --llm openai --severity medium  # Medium+ with OpenAI\n.\\thales_windows_amd64.exe --cb . --llm claude --focus all  # Full review with Claude\n\n# Advanced options\n.\\thales_windows_amd64.exe --list-languages         # Show languages\n.\\thales_windows_amd64.exe --llm openai             # Use OpenAI\n.\\thales_windows_amd64.exe --review-output reviews  # Set review output\n.\\thales_windows_amd64.exe --cb . --pdf             # Review codebase with PDF output\n.\\thales_windows_amd64.exe --sf main.go --pdf       # Review single file with PDF output\n.\\thales_windows_amd64.exe --cb . --html            # Review codebase with HTML output\n.\\thales_windows_amd64.exe --sf main.go --html      # Review single file with HTML output\n```\n\n4. **Finish**\n\nTo unset the environment variables you set, you can use the following command:\n\n```bash\nunset ANTHROPIC_API_KEY \u0026\u0026 \\\nunset OPENAI_API_KEY \u0026\u0026 \\\nunset GROK_API_KEY \u0026\u0026 \\\nunset MIXTRAL_API_KEY\n```\n\n### License\n\nThis project is licensed under the BSD 3-Clause License - see the [LICENSE](LICENSE) file for details.\n\n### Citation\n\n```tex\n@misc{thalesafo2025,\n  author       = {Oketunji, A.F.},\n  title        = {Thales},\n  year         = 2025,\n  version      = {1.0.8},\n  publisher    = {Finbarrs Oketunji},\n  doi          = {10.5281/zenodo.14994039},\n  url          = {https://doi.org/10.5281/zenodo.14994039}\n}\n```\n\n### Copyright\n\n(c) 2025 Finbarrs Oketunji. All Rights Reserved.\n\n\u003e Thanks for all the emails! It is named after [Thales of Miletus](https://en.wikipedia.org/wiki/Thales_of_Miletus).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xnu%2Fthales","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xnu%2Fthales","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xnu%2Fthales/lists"}