{"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,"search_vec":"'0.4.0':32 'ad':56 'ai':25,100,122 'allow':106 'autom':93,108 'automata':1,5 'automata-c':4 'azur':142 'branch':86 'bug':60 'cadenc':37 'claim':112 'claud':103 'cleanup':87 'cli':2,6,139 'code':125 'codex':105 'command':10 'command-lin':9 'comprehens':69 'configur':67 'continu':55 'current':28 'design':14 'detail':81 'devop':143 'differenti':63 'e.g':46 'environ':144 'evidenc':39 'execut':121,129,131 'execute-prompt':130 'executor':101 'featur':58,84 'find':111 'finish':83 'finish-featur':82 'fix':61,128 'frequent':41 'get':75 'get-pr-info':74 'gh':138 'git':17 'gitflow':70 'github':115,137 'helper':71 'implement':114,118 'implement-next':117 'includ':64 'info':77 'integr':23,98,140 'interact':66 'interfac':12 'issu':116 'javascript':145 'key':62 'like':102,110 'line':11 'manag':20 'minor':42 'new':57 'next':119 'patch':44 'period':54 'pr':76 'project':19 'prompt':123,132 'publish':90 'publish-releas':89 'pull':79 'rapid':35 'refactor':126 'relat':52 'releas':36,91,94 'request':80 'sequenc':95 'servic':26 'short':53 'stabl':29 'streamlin':16 'support':135 'task':109 'tool':13,134 'uniqu':97 'updat':45 'v0.2.x':47 'v0.3.x':48 'v0.4.x':49 'version':30 'wizard':68 'workflow':21","created_at":"2026-04-23T17:46:37.793439+00:00","updated_at":"2026-04-23T17:46:37.793439+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"automata","cli_version":null,"type":"library","homepage":"https://automata-cli.com","github":"https://github.com/alkampfergit/automata-cli","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/automata-cli","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","llm-agents","workflow","crm-productivity"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-04-23","next_check":"2026-07-22","install_tag":null}}