# Getting started with the CircleCI CLI

DevFeed: [Getting started with the CircleCI CLI](<https://devfeed.tech/articles/getting-started-with-the-circleci-cli-96298.md>)

Original publisher: [Read original article](<https://circleci.com/blog/getting-started-with-the-circleci-cli/>)

Author: Roger Winter

Published: 2026-10-22T16:00:00Z

Content type: tutorial

Language: en

Sources: [CircleCI](<https://devfeed.tech/sources/the-circleci-blog-feed-circleci.md>)

Topics: [circleci cli](<https://devfeed.tech/topics/circleci-cli.md>), [CircleCI](<https://devfeed.tech/topics/circleci.md>), [CI/CD](<https://devfeed.tech/topics/cicd.md>), [Tutorial](<https://devfeed.tech/topics/tutorial.md>), [Agent Skills](<https://devfeed.tech/topics/agent-skills.md>), [Visual Studio Code](<https://devfeed.tech/topics/visual-studio-code.md>), [cURL](<https://devfeed.tech/topics/curl.md>)

Tags: [2](<https://devfeed.tech/tags/2.md>), [3](<https://devfeed.tech/tags/3.md>), [account](<https://devfeed.tech/tags/account.md>), [agents](<https://devfeed.tech/tags/agents.md>), [ai-coding-agents](<https://devfeed.tech/tags/ai-coding-agents.md>), [ai-development](<https://devfeed.tech/tags/ai-development.md>), [changes](<https://devfeed.tech/tags/changes.md>), [ci-cd-tutorial](<https://devfeed.tech/tags/ci-cd-tutorial.md>), [ci-for-coding-agents](<https://devfeed.tech/tags/ci-for-coding-agents.md>), [circleci](<https://devfeed.tech/tags/circleci.md>), [circleci-cli](<https://devfeed.tech/tags/circleci-cli.md>), [circleci-cli-for-coding-agents](<https://devfeed.tech/tags/circleci-cli-for-coding-agents.md>), [circleci-cli-tutorial](<https://devfeed.tech/tags/circleci-cli-tutorial.md>), [circleci-run-get-failure-report](<https://devfeed.tech/tags/circleci-run-get-failure-report.md>), [cli](<https://devfeed.tech/tags/cli.md>), [coding](<https://devfeed.tech/tags/coding.md>), [coding-agents](<https://devfeed.tech/tags/coding-agents.md>), [commands](<https://devfeed.tech/tags/commands.md>), [connect](<https://devfeed.tech/tags/connect.md>), [debugging-failed-builds](<https://devfeed.tech/tags/debugging-failed-builds.md>), [developer-tools](<https://devfeed.tech/tags/developer-tools.md>), [engineering](<https://devfeed.tech/tags/engineering.md>), [getting](<https://devfeed.tech/tags/getting.md>), [getting-started](<https://devfeed.tech/tags/getting-started.md>), [how-to](<https://devfeed.tech/tags/how-to.md>), [install-circleci-cli](<https://devfeed.tech/tags/install-circleci-cli.md>), [monitoring](<https://devfeed.tech/tags/monitoring.md>), [pipelines](<https://devfeed.tech/tags/pipelines.md>), [tutorials](<https://devfeed.tech/tags/tutorials.md>), [using](<https://devfeed.tech/tags/using.md>), [validating](<https://devfeed.tech/tags/validating.md>), [with](<https://devfeed.tech/tags/with.md>)

## AI overview

CircleCI's CLI lets coding agents and developers monitor pipelines, diagnose failures, retrieve test results, logs and artifacts, and validate configuration from a terminal. Agents can use shell commands with structured JSON output and exit codes, or the CLI's local MCP server through supported editors; both use existing CLI authentication. The tutorial covers installation, sign-in and project onboarding, then demonstrates tracing a deliberate version-comparison bug through a consolidated failure report and targeted test and artifact commands. `circleci config validate` checks configuration before a push, while `run watch` reports pass or failure and `--failfast` exits when a job fails. Workflow reruns can help investigate flaky failures, though the article says developers should establish when agents need approval for reruns or cancellations. CLI v1 supports CircleCI Cloud; CircleCI Server users should continue with v0.

## Source excerpt

Learn how to connect coding agents to CircleCI using the CLI, with commands for monitoring pipelines, diagnosing failures, and validating changes.