Agent CLI — 터미널에서 AgentUI 앱 만들기
Agent CLI는 AgentUI 프로젝트를 일반 파일로 내려받습니다. VS Code나 Cursor에서 편집하고, git으로 관리하고, 변경분을 다시 올립니다. 모든 명령이 --json을 지원하기 때문에 사람뿐 아니라 Claude Code, Codex, Aider가 직접 실행할 수 있습니다.
MIT 라이선스, Node 22 이상. 문서를 읽는 데 가입이 필요 없습니다.
$ npm install -g @agentuiai/cli
$ agentui auth login
$ agentui project create --name "Ops Dashboard"
→ ./ops-dashboard (AGENTS.md + skeleton)
$ agentui --json project list
{
"total": 2,
"projects": [
{ "name": "Ops Dashboard", "type": "APP_V2" },
{ "name": "Nightly Report", "type": "AUTOMATION" }
]
}모든 명령이 JSON을 반환하므로 AI 에이전트가 직접 다룰 수 있습니다
루트 명령에 --json을 붙이면 모든 하위 명령이 표준 출력으로 기계가 읽을 수 있는 결과를 돌려줍니다. 오류도 마찬가지이며, AWS와 GitHub CLI와 같은 방식입니다. 에이전트가 쓸 수 있는 도구와 화면을 긁어야 하는 도구의 차이가 여기서 갈립니다.
sync, edit, push — 내 소유의 파일로 다루는 프로젝트
sync는 페이지, 컴포넌트, 함수, 엔티티 스키마를 .jsx와 .schema.json으로 디스크에 씁니다. push는 작업 트리를 로컬 매니페스트와 비교해 차이만 전송하며, --dry-run을 붙이면 아무것도 보내기 전에 무엇을 보낼지 그대로 보여줍니다.
$ agentui project sync <workflowId>
components/ pages/ functions/ entities/
$ code . # edit with anything
$ agentui project push --dry-run # see the diff first
$ agentui project push하지 않는 일
시크릿 값은 서버를 벗어나지 않습니다. secrets list에도, sync 번들에도 들어가지 않습니다. 경로 탐색은 읽기·쓰기·삭제 전부에서 거부됩니다. 모든 엔드포인트가 해당 워크플로를 내 회사가 소유하는지 확인하며, 다른 테넌트의 요청에는 403이 아니라 404를 돌려주어 리소스의 존재조차 알려주지 않습니다.
명령어 레퍼런스
| agentui auth | Log in with an emailed 6-digit code; check or clear the session. |
|---|---|
| agentui workspace | List the workspaces you belong to and select the active one. |
| agentui project | create, list, sync, init, status, push — the core loop. |
| agentui env | Read and switch the environment a project is pointed at. |
| agentui secrets | List and request secrets. Values stay server-side. |
| agentui validate | Check a project for errors before you push it. |
| agentui build | Build the project bundle. |
| agentui deploy | Ship a built project. |
| agentui skills | Manage the skills available to a project. |
| agentui packages | Manage npm packages a project depends on. |
| agentui blueprints | Work with prebuilt app blueprints. |
| agentui prompts | Manage the prompts a project uses. |
| agentui functions | Inspect and manage server functions. |
| agentui integrations | List and configure third-party integrations. |
| agentui report | Report something broken or missing, from the terminal. |
전체 레퍼런스와 플래그, 종료 코드, 문제 해결은 npm의 README에 있습니다. @agentuiai/cli
AI 어시스턴트로 읽고 계신가요? 전체 명령 목록이 단일 마크다운 파일에 있습니다: /agentui-cli.md
설치하고 첫 프로젝트를 동기화하세요
npm install -g @agentuiai/cliMIT 라이선스, Node 22 이상. 문서를 읽는 데 가입이 필요 없습니다.