Aside CLI 사용법: 터미널에서 자연어로 브라우저 자동화하기

Aside를 브라우저 앱에서만 사용하면 작업을 직접 입력하고 결과를 확인하는 데 익숙해집니다. 하지만 개발 중인 로컬 사이트를 점검하거나, 같은 작업을 터미널·스크립트·코딩 에이전트에서 반복하려면 Aside CLI가 더 편리합니다.

CLI에서는 브라우저를 열고 여러 단계를 수행하는 작업을 자연어 한 줄로 시작할 수 있습니다. 실행 명령을 터미널 기록과 함께 남길 수 있고, 세션을 이어가거나 특정 계정과 모델을 지정할 수도 있습니다.

이 글에서는 설치는 짧게 다루고, CLI를 써야 하는 이유와 주요 사용법, 자주 복사해 쓸 명령어를 중심으로 설명합니다. 공식 문서는 Aside CLI·MCP·REPL 안내를 기준으로 했습니다.

Aside를 CLI로 실행하는 이유

브라우저 앱과 CLI는 같은 Aside 기능을 서로 다른 작업 흐름에 연결합니다.

상황	브라우저 앱	CLI
한 번만 페이지를 요약할 때	편리함	가능하지만 터미널을 열어야 함
로컬 개발 서버를 점검할 때	주소와 작업을 직접 입력	명령어로 매번 같은 검사 실행
작업을 기록하고 공유할 때	채팅 화면 중심	셸 기록, 스크립트와 함께 보관
기존 작업을 이어갈 때	Task를 찾아 열기	`--session`으로 바로 재개
코딩 도구와 연결할 때	별도 설정 필요	`aside mcp`로 MCP 서버 시작

특히 다음과 같은 작업은 CLI에서 시작하는 편이 좋습니다.

localhost에서 실행 중인 페이지의 제목·H1·이미지·가로 스크롤 점검
공개 문서의 내용을 읽고 정해진 형식으로 요약
같은 브라우저 작업을 여러 번 실행하고 결과를 터미널 로그로 남기기
Codex나 다른 코딩 도구에서 Aside 브라우저 기능 사용
자연어 작업은 CLI로 시작하고, 정밀한 브라우저 조작은 REPL로 이어가기

반대로 로그인, 결제, 게시와 같이 사람의 승인이 필요한 작업은 CLI 한 줄로 자동 실행하기보다 Guard 권한과 승인 단계를 먼저 설계해야 합니다.

설치 방법은 간단하게

Aside를 설치한 뒤 터미널에서 공식 설치 명령을 실행합니다.

Aside CLI 설치

curl -fsSL https://releases.aside.com/install.sh | bash

설치가 끝나면 버전을 확인합니다.

설치 확인

aside --version
aside --help

개발자 설정 화면에서 CLI를 설치·업데이트·재설치할 수도 있습니다. 명령이 인식되지 않으면 터미널을 다시 열고 which aside로 실행 파일 경로를 확인하세요.

가장 기본적인 사용법

자연어로 브라우저 작업 시작하기

프롬프트를 따옴표로 감싸 aside 뒤에 전달합니다.

현재 페이지 요약

aside "Open https://example.com and return the page title and a Korean one-sentence summary. Do not modify the page or create files."

URL만 전달하면 해당 페이지를 여는 작업으로 시작할 수도 있습니다.

URL 열기

aside https://example.com

좋은 CLI 프롬프트에는 대상 사이트, 원하는 결과, 결과 형식과 금지 행동을 함께 적습니다. Handle my billing처럼 범위가 넓은 문장보다 “어느 사이트에서 무엇을 읽고, 무엇은 하지 말아야 하는지”를 구체적으로 쓰는 편이 안전합니다.

기존 세션 이어가기

긴 작업이 끝나기 전에 추가 지시를 하거나, 이전 결과를 바탕으로 다음 단계를 실행하려면 세션 ID를 사용합니다.

기존 세션 계속하기

aside --session <session-id> "Continue by checking the sources and list anything that is still missing."

세션 ID는 CLI 실행 결과에 표시됩니다. 셸 변수나 작업 로그에 저장해 두면 여러 단계의 작업을 재현하기 쉽습니다.

계정과 모델 옵션

계정 확인과 전환

여러 Aside 계정을 사용한다면 현재 선택된 계정을 먼저 확인합니다.

Aside 계정 관리

aside account list
aside account status
aside account status <account-id>
aside account use <account-id>

한 번의 실행에서만 계정을 지정하려면 전역 옵션으로 --account를 붙입니다.

특정 계정으로 한 번 실행

aside --account <account-id> "Summarize the current page"

선택한 계정이 로그아웃 상태라면 CLI가 복구 방법을 안내합니다. 기본 Aside 모델을 사용하려면 해당 계정이 로그인되어 있어야 하므로, 실행 전에 account status를 확인하는 습관이 좋습니다.

모델·속도·추론 수준 지정

--model, --provider, --speed, --effort 옵션으로 한 번의 작업에 사용할 설정을 바꿀 수 있습니다.

모델과 추론 수준 지정

aside --model openai-codex/gpt-5.5 --speed fast --effort high "Plan a read-only smoke test for localhost:3000."

출처가 많은 조사와 복잡한 비교에는 --effort ultrabrowse를 사용할 수 있습니다. 단일 페이지 요약이나 기본 검색은 일반 작업이 더 빠릅니다.

CLI 활용 사례

1. 로컬 사이트 읽기 전용 스모크 테스트

개발 중인 블로그나 웹앱을 열고, 변경 없이 핵심 화면을 검사하는 예시입니다.

로컬 사이트 스모크 테스트

aside "Open http://localhost:3000/blog/aside-install-guide and perform a read-only smoke test. Check the page title, visible H1, visible broken images, horizontal overflow, and browser console errors. Do not click links, submit forms, create files, take screenshots, or modify anything. Report PASS, FAIL, or NOT VERIFIED."

검사 항목을 고정하면 같은 명령을 배포 전마다 반복할 수 있습니다. 모바일 검사가 필요하면 “390×844 뷰포트에서도 확인”처럼 뷰포트 조건을 프롬프트에 추가합니다.

2. 공식 문서만 사용한 조사

CLI에서도 Ultrabrowse 추론 수준을 지정해 여러 공식 출처를 비교할 수 있습니다.

공식 문서 비교 조사

aside --effort ultrabrowse "Using only official Aside Help Center pages, compare Tasks, Routines, CLI, MCP, and REPL. Return a Korean table with when to use each tool, limitations, and citations. Mark undocumented items as not confirmed."

3. 결과 형식을 고정한 반복 작업

자연어 지시문에 반환 형식을 넣으면 터미널 로그를 후속 도구에서 처리하기 쉬워집니다.

정해진 형식으로 반환

aside "Open https://example.com. Return exactly three lines: TITLE=<page title>, SUMMARY=<one Korean sentence>, LINKS=<visible link texts>. Do not create files or modify the page."

파일 저장이나 외부 서비스 전송까지 포함할 때는 작업 폴더와 허용 파일, 금지 행동을 함께 지정하고 Guard 권한을 사용하세요.

CLI·exec·MCP·REPL 구분하기

CLI는 기본적으로 자연어 브라우저 작업을 시작하는 진입점입니다. 같은 기능을 더 세밀하게 제어해야 할 때는 하위 명령을 선택합니다.

명령	언제 사용하나	예시
`aside "..."`	자연어 작업 시작	`aside "Summarize this page"`
`aside exec "..."`	세션·모델·계정 옵션을 명시한 실행	`aside exec --effort high "Plan a test"`
`aside mcp`	코딩 도구에 브라우저 기능 연결	`aside mcp`
`aside repl "..."`	브라우저 탭·요소·스크린샷을 코드로 제어	`aside repl "const p = await openTab('https://example.com')"`

exec는 자연어 작업을 실행하는 형태를 명시하고 싶을 때 유용하고, repl은 결정적인 순서의 브라우저 자동화가 필요할 때 적합합니다. MCP는 Codex나 다른 MCP 클라이언트가 Aside를 도구로 호출하게 만드는 연결 방식입니다.

자주 쓰는 Aside CLI 명령어

명령어	용도
`aside --help`	전체 옵션과 하위 명령 확인
`aside --version`	설치된 CLI 버전 확인
`aside "프롬프트"`	자연어 브라우저 작업 시작
`aside <URL>`	URL을 열며 작업 시작
`aside --session <id> "프롬프트"`	기존 세션 이어가기
`aside --account <id> "프롬프트"`	특정 계정으로 한 번 실행
`aside account list`	로컬 계정 목록 확인
`aside account status`	현재 계정 상태 확인
`aside account use <id>`	기본 계정 전환
`aside exec "프롬프트"`	실행 하위 명령 사용
`aside repl "코드"`	브라우저 자동화 JavaScript 실행
`aside mcp`	MCP 서버를 stdio로 시작
`aside --update`	CLI 업데이트 확인 및 설치

명령의 세부 옵션은 버전에 따라 달라질 수 있으므로 aside <command> --help를 함께 확인하세요. 예를 들어 aside exec --help는 --session, --model, --provider, --speed, --effort 옵션을 보여줍니다.

실행 전에 확인할 것

로그인·결제·게시·메시지 전송은 반드시 승인 단계로 분리합니다.
파일을 만들거나 수정할 때 결과 경로와 허용 파일명을 프롬프트에 적습니다.
공개 페이지 읽기 작업은 Read only에 해당하는 지시로 시작합니다.
CLI 실행 폴더와 Aside Project 작업 폴더가 다를 수 있으므로 파일 경로를 확인합니다.
자동화 실패 시 에이전트 오류와 대상 사이트 장애를 구분합니다.
비밀번호, 고객 정보, 인증 코드와 같은 민감한 값은 프롬프트와 로그에 남기지 않습니다.

Aside CLI의 핵심은 복잡한 셸 문법이 아니라, 브라우저에서 하던 작업을 재현 가능한 자연어 명령으로 바꾸는 데 있습니다. 처음에는 aside --version과 aside --help로 설치 상태를 확인하고, 공개 페이지 요약이나 로컬 사이트 읽기 전용 검사부터 시작해 보세요.