{"id":17502,"library":"automata-cli","title":"Automata CLI","description":"The `automata-cli` is a command-line interface tool designed to streamline Git and project management workflows by integrating with AI services. Its current stable version is 0.4.0, with a rapid release cadence, as evidenced by frequent minor and patch updates (e.g., v0.2.x, v0.3.x, v0.4.x) over a relatively short period, continuously adding new features and bug fixes. Key differentiators include an interactive configuration wizard, comprehensive GitFlow helpers such as `get-pr-info` for pull request details, `finish-feature` for branch cleanup, and `publish-release` for automated release sequences. It uniquely integrates with AI executors like Claude and Codex, allowing for automated tasks like finding, claiming, and implementing GitHub issues (`implement-next`), or executing AI prompts for code refactoring and fixes (`execute`, `execute-prompt`). The tool supports both GitHub (`gh CLI` integration) and Azure DevOps environments.","status":"active","version":"0.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/alkampfergit/automata-cli","tags":["javascript"],"install":[{"cmd":"npm install automata-cli","lang":"bash","label":"npm"},{"cmd":"yarn add automata-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add automata-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for most `automata git` commands (e.g., `get-pr-info`, `finish-feature`) and `automata implement-next` when configured for GitHub.","package":"gh CLI","optional":false}],"imports":[],"quickstart":{"code":"# 1. Install the CLI globally\nnpm install -g automata-cli\n\n# 2. Launch the interactive configuration wizard\n#    Follow prompts to select your remote environment (e.g., GitHub 'gh' or Azure DevOps 'azdo')\nautomata config\n\n# 3. Verify installation and explore available commands\nautomata --help\n\n# 4. Example: Get information about the current Git branch's pull request (requires 'gh' CLI)\n#    Ensure you are in a Git repository with an active branch pushed to a PR.\nautomata git get-pr-info\n\n# 5. Example: Preview the next GitHub issue for AI implementation (requires 'gh' CLI and AI configuration)\nautomata implement-next --query-only\n\n# 6. Example: Set config type non-interactively\nautomata config set type gh","lang":"bash","description":"Installs the CLI globally, launches the interactive configuration wizard, verifies installation, and demonstrates how to check PR information and preview AI-driven issue discovery."},"warnings":[{"fix":"Install and authenticate the `gh` CLI: `npm install -g @cli/cli` and then `gh auth login`.","message":"Many Git-related commands and `automata implement-next` require the `gh` CLI (GitHub CLI) to be installed and authenticated for GitHub operations. Without it, these commands will fail.","severity":"gotcha","affected_versions":">=0.2.0"},{"fix":"Pin exact versions in `package.json` or carefully review release notes before upgrading `0.x.x` versions.","message":"This package is currently in major version 0 (e.g., `0.4.0`), indicating an unstable API. Breaking changes are likely to occur between minor versions (e.g., `0.3.x` to `0.4.x`) without adhering to strict semver for major version increments. Review changelogs carefully when upgrading.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Consult the `automata-cli` documentation for details on configuring AI providers and managing API keys and costs.","message":"AI commands (`implement-next`, `execute`, `execute-prompt`) interact with external AI models (Claude, Codex) and may incur costs or require specific API keys/configuration not detailed in basic usage. Ensure your environment is properly set up for AI service access.","severity":"gotcha","affected_versions":">=0.3.0"},{"fix":"Run `automata config` from your project's root directory, or ensure the `.automata` directory with `config.json` is present and correctly configured in your working directory.","message":"The `automata` CLI saves its configuration to `.automata/config.json` in the current directory where the command is executed. Running the CLI from different directories may result in different configurations being used, or the need to re-run `automata config`.","severity":"gotcha","affected_versions":">=0.2.0"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Run `npm install -g automata-cli` to install the CLI globally.","cause":"The `automata-cli` package is not installed globally or its executable path is not in your system's PATH.","error":"'automata' is not recognized as an internal or external command, operable program or batch file."},{"fix":"Install `gh` (e.g., `npm install -g @cli/cli` or via system package manager) and run `gh auth login` to authenticate.","cause":"The GitHub CLI (`gh`) is either not installed, not accessible in your system's PATH, or you are not authenticated with GitHub via `gh auth login`.","error":"Error: The gh CLI is required for GitHub operations. Please install it and ensure you are authenticated."},{"fix":"Run `automata config` to launch the interactive wizard and create the configuration file.","cause":"The `automata` CLI cannot find its configuration file in the expected location (typically `.automata/config.json` in the current directory).","error":"Error: Configuration file not found at .../.automata/config.json. Please run 'automata config' to set up."},{"fix":"Add the `--with` flag followed by `claude` or `codex`, e.g., `automata execute --with claude --prompt \"...\"`.","cause":"AI execution commands (`automata execute`, `automata execute-prompt`) require you to specify which AI model to use.","error":"Error: You must provide a --with option (claude or codex)."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}