Agora를 사용하여 개발하는 개발자와 AI 코딩 에이전트(AI coding agents)를 위한 명령줄 인터페이스(Command-line interface, CLI)입니다.

AI 코딩 에이전트(AI coding agents)는 앱을 생성할 수 있지만, 초기 설정에는 여전히 사람의 개입이 필요합니다. 프로젝트를 생성하고, 프로젝트 자격 증명(credentials)을 가져오고, 에이전트 컨텍스트(agent context)에 비밀 정보(secrets)를 노출하지 않으면서 환경 변수 파일(.env file)을 생성하며, 불필요한 보일러플레이트(boilerplate) 코드가 생성되지 않도록 적절한 퀵스타트(quickstart)를 선택해야 합니다. 개발자들도 동일한 과정을 반복합니다. 콘솔을 열고, 값을 복사하고, 다시 터미널로 돌아와 환경 변수 파일을 만들고, 에이전트가 시작할 때 좋은 예시를 가질 수 있도록 퀵스타트 링크를 검색해야 합니다.

오늘 우리는 이러한 설정 경로를 터미널로 옮기기 위해 Agora CLI를 출시합니다. 개발자, 스크립트, 그리고 에이전트(agents)는 이미 사용 중인 워크플로를 벗어나지 않고도 CLI를 사용하여 환경 변수 파일을 작성하고, 스타터 저장소(starter repos)를 스캐폴딩(scaffold)하며, Agora 환경의 준비 상태를 확인할 수 있습니다. 대부분의 CLI 도구는 사람이 읽기 쉬운 출력을 출력하는데, 이는 코딩 에이전트가 느슨한 터미널 텍스트를 파싱(parsing)하게 만듭니다. Agora CLI는 인간과 에이전트 모두를 지원하며, 에이전트가 파싱하여 실행할 수 있는 구조화된 응답을 반환하는 JSON 출력 모드를 제공합니다. 우리는 우리 자신의 에이전트 기반 개발 워크플로(agentic development workflows)를 위해 이 CLI를 구축했습니다. 이제 Agora 개발자들이 자신의 에이전트에게 프로젝트를 프로비저닝(provision)하고, 환경 변수 파일을 작성하며, 설정을 터미널 내부에서 유지할 수 있는 동일한 능력을 부여할 수 있도록 이를 출시합니다.

설치부터 실행 가능한 프로젝트까지의 가장 짧은 경로는 세 가지 명령입니다:

curl -fsSL https://agoraio.github.io/cli/install.sh | sh
agora login
agora init my-python-demo --template python

agora init은 Agora 프로젝트를 생성하거나 연결하고, 선택한 퀵스타트(quickstart)를 클론(clones)하며, 해당 퀵스타트가 요구하는 환경 변수 파일을 작성하고, .agora/project.json에 저장소 로컬 바인딩(repo-local binding)을 기록한 뒤 다음 단계를 출력합니다. 템플릿은 Next.js, Python, Go를 지원합니다.

명령어 인터페이스 (The Command Surface)

CLI는 계정 수준의 작업과 로컬 프로젝트 설정을 분리합니다:

agora
├── init        # 프로젝트 생성 또는 바인딩, 퀵스타트 (quickstart) 클론, 환경 변수 (env) 작성
├── project     # 프로젝트, 기능 (features), 자격 증명 (credentials), 준비 상태 (readiness)
...

단 한 번의 명령어로 전체 온보딩 (onboarding) 경로를 진행하고 싶을 때는 init을 사용하세요. 각 단계를 검사하거나 제어하고 싶을 때는 project와 quickstart로 들어가면 됩니다:

agora project create my-agent-demo --feature rtc --feature convoai
agora quickstart create my-python-demo --template python --project my-agent-demo
agora quickstart env write my-python-demo --project my-agent-demo

CLI는 개발자들이 자주 사용하는 일상적인 확인 작업도 지원합니다:

agora -v         # 설치된 버전 표시
agora help       # 명령어 및 플래그 (flags) 학습
agora whoami     # 현재 로그인 상태 확인
...

CLI는 퀵스타트 (quickstart), 자격 증명 (credentials), 그리고 프로젝트 바인딩 (project binding)을 일치하게 유지합니다. 선택한 템플릿이 기대하는 환경 변수 (env) 파일을 작성하고, 이미 추가한 값을 보존하며, 어떤 Agora 프로젝트가 해당 리포지토리 (repo)에 속해 있는지 기억하여 향후 명령어가 잘못된 설정으로 벗어나지 않도록 합니다. 내부적으로 CLI는 리포지토리 로컬 프로젝트 메타데이터 (metadata)를 .agora/project.json에 저장합니다. 해당 리포지토리에서 다른 명령어를 실행하면, CLI는 전역 프로젝트 선택 (global project selection)으로 넘어가기 전에 해당 바인딩을 먼저 사용합니다.

에이전트(Agents)를 위해 구축되었고, 인간에게 유용합니다

Agora Skills는 AI 코딩 어시스턴트에게 Agora의 제품과 통합 패턴 (integration patterns)을 이해할 수 있는 컨텍스트 (context)를 제공합니다. CLI는 해당 어시스턴트에게 실행할 수 있는 수단을 제공합니다.

이것이 중요한 이유는 설정 작업이 프로젝트 구성 (project configurations), 환경 변수 (env) 파일 설정, 기능 준비 상태 (feature readiness), 퀵스타트 바인딩 (quickstart bindings), 그리고 로컬 진단 (local diagnostics)과 같은 외부 의존성 (external dependencies)으로 가득 차 있기 때문입니다. 코딩 에이전트는 문서를 통해 소스 코드를 작성할 수는 있지만, 플랫폼에 무엇이 존재하는지 묻고 변경이 필요한 부분을 변경할 수 없다면 실제 설정을 완료할 수 없습니다.

에이전트 및 자동화 워크플로 (workflows)를 위해서는, 사람이 읽기 좋은 터미널 출력 대신 구조화된 데이터 (structured data)를 반환하는 --json 옵션을 사용하세요:

agora doctor --json
agora auth status --json
agora project env --json
...

JSON 모드에서 명령은 인증 상태 (auth state), 프로젝트 메타데이터 (project metadata), 환경 변수 값 (env values), 진단 정보 (diagnostics), 그리고 명령 기능 (command capabilities)과 같이 스크립트나 에이전트가 직접 검사할 수 있는 필드들을 반환합니다.

agora introspect --json은 어떤 명령이 헤드리스 실행 (headless runs)에 안전한지를 포함하여, 명령 트리 (command tree)를 기계가 읽을 수 있는 형식으로 노출합니다. agora mcp serve를 사용하면 MCP 클라이언트가 터미널 텍스트를 스크래핑 (scraping)하는 대신 로컬 도구를 통해 CLI를 호출할 수 있습니다.

콘솔은 시각적인 제어 평면 (control plane) 역할을 유지합니다. CLI는 개발자, 스크립트, 그리고 에이전트에게 터미널을 통해 동일한 설정 작업을 수행할 수 있는 신뢰할 수 있는 경로를 제공합니다.

설치 (Install)

curl -fsSL https://agoraio.github.io/cli/install.sh | sh
Windows에서는 PowerShell로 설치하세요:

irm https://agoraio.github.io/cli/install.ps1 | iex
설치 프로그램은 기본적으로 PATH와 셸 완성 (shell completion)을 구성합니다.

설치 후, agora doctor는 해결된 바이너리 (resolved binary), 버전, PATH, 네트워크 액세스 (network access), 인증 상태 (auth state), 그리고 프로젝트 준비 상태 (project readiness)를 포함한 로컬 CLI 설정을 점검합니다.

시작하기 (Get Started)

CLI를 설치하고 agora login을 실행한 후에는, 공식 퀵스타트 (quickstarts) 중 하나로 시작할 수 있습니다:

agora init my-python-demo --template python
agora init my-nextjs-demo --template nextjs
agora init my-go-demo --template go

전체 CLI 문서는 Agora CLI Docs에서 확인할 수 있습니다.

이것은 첫 번째 릴리스 (release)입니다. 명령이 누락되었거나 설정 경로가 여전히 수동 프로젝트 작업을 강제하는 경우, 이슈를 제기(open an issue)해 주세요. 해당 피드백은 다음 버전을 형성하는 데 도움이 될 것입니다.

원문은 Agora blog에 처음 게시되었습니다.