aipctl

aipctl은 Duplo AIP API command와 기존 MCP native command를 하나로 통합한 CLI입니다.

Requirements

• Node.js 24.18.0+

Install

npm install -g aipctl
npx aipctl --help

AIP setup

aipctl config set --app-url https://app.example.com
aipctl auth login
aipctl org list
aipctl org select

설정과 credentials 경로는 기존 ~/.config/aip를 유지합니다.

MCP native commands

aipctl install <presetName> <presetId> --key <apiKey>
aipctl run <config>
aipctl tunnel link <token>

install, run, tunnel, logs는 Go native binary로 lazy dispatch됩니다. prod build에서는 logs command가 help와 command tree에서 제외됩니다.

Experimental model execution

aipctl model-exec은 CLI 전용 one-shot 모델 실행 namespace입니다. Conversation을 만들지 않고, 사용자가 선택한 모델을 한 번 호출해 stdout 또는 파일로 결과를 받습니다.

aipctl model-exec models [--type chat|image-generation] [--json]
aipctl model-exec get <model-id> [--json]
aipctl model-exec sample <model-id> [--save input.json]
aipctl model-exec chat --model <chat-model-id> -m "hello" [--json]
aipctl model-exec image generate --model <image-model-id> --prompt "cat" --output ./cat.png [--json]

대화형 터미널에서는 model-exec chat과 model-exec image generate가 완료될 때까지 spinner와 경과 시간을 stderr에 표시합니다. JSON을 포함한 최종 결과는 기존처럼 stdout에만 출력됩니다.

model-exec image generate의 이미지 생성 요청 timeout은 최대 5분입니다. 5분 안에 provider 응답이 완료되지 않으면 명령은 실패하며, 이 제한은 one-shot image-generation 요청에만 적용됩니다. aipctl model-exec image generate --help와 실행 중 spinner에서도 제한을 확인할 수 있습니다.

Conversation을 유지하는 일반 채팅은 chat send를 사용합니다.

aipctl chat send -m "hello" --json
aipctl chat send --conversation <conversation-id> -m "continue" --json

Development

cd desktop
pnpm install
pnpm run cli:typecheck
pnpm run cli:lint
pnpm run cli:test:ts
pnpm run cli:test:wrapper
pnpm run cli:test:go
pnpm run cli:help:check

Local run:

mise run desktop:cli:local -- --help
mise run desktop:cli:local -- auth --help
mise run desktop:cli:local -- run --help

Architecture

자세한 구조는 docs/architecture.md를 봅니다.