터미널 대신 브라우저로 옮긴 코딩 에이전트

터미널 스크롤백 대신 브라우저 화면에서 코딩 에이전트를 다루는 오픈소스 도구 미라폴드(Mirafold)가 공개됐다. 클로드 코드(Claude Code)·코덱스(Codex)·제미나이 CLI(Gemini CLI)를 그대로 쓰되 출력만 카드·표·차트 같은 화면 요소로 바꿔 보여준다. MIT 라이선스로 배포되며 노드(Node) 22 이상에서 명령 한 줄로 설치한 뒤 프로젝트 폴더에서 실행하면 브라우저가 열린다.

무슨 일인가 / 배경

코딩 에이전트를 오래 써 본 사람이면 같은 불편을 겪는다. 에이전트는 점점 많은 일을 하는데, 그 결과는 여전히 위로 흘러가는 텍스트 더미로만 남는다. 어떤 파일이 바뀌었는지, 지금 무슨 단계인지, 토큰을 얼마나 썼는지를 확인하려면 스크롤을 거슬러 올라가야 한다. 미라폴드는 에이전트를 바꾸는 대신 출력을 보여주는 층만 갈아 끼우는 방식을 택했다.

핵심 짚어보기

설계의 핵심은 에이전트 출력을 글이 아니라 화면 지시 흐름으로 취급한다는 점이다. 마크다운은 그대로 흘려보내되, 글보다 요소가 더 잘 설명하는 대목에서는 에이전트가 직접 카드·표·차트·작업목록을 붙인다. 맞는 요소가 없으면 잠긴 샌드박스 안에 임의 화면을 만들어 넣는다. 한 번 고정해 둔 블록은 이후 턴에서도 자리를 지키며 내용만 갱신된다.

보안 경계도 분명히 그었다. 에이전트는 출력 영역만 그릴 수 있고 입력창·연결·자격증명이 있는 영역에는 손대지 못한다. 에이전트가 만든 HTML은 네트워크가 차단된 격리 프레임에서만 실행된다. 느낌표를 앞에 붙인 명령은 진짜 터미널로 넘어가므로, 관리자 권한 암호 입력창도 정상 동작하고 그 입력값은 에이전트가 보지 못한다.

기능 범위는 터미널의 상위 집합을 표방한다. 사고 과정, 도구 상세와 변경 diff, 하위 에이전트 진행 상황, 실시간 작업목록, 토큰·비용 사용량이 모두 흘러나오다가 한 줄로 접힌다. 세션은 여러 개를 각각 다른 폴더·다른 에이전트로 띄울 수 있고, 하나의 세션에 여러 화면을 동시에 붙여 어느 쪽에서든 조종할 수 있다. 데몬은 로컬에서 돌고 API 키는 브라우저로 넘어가지 않으며, 올라마(Ollama)·LM 스튜디오(LM Studio)·vLLM 같은 로컬 모델을 물릴 수도 있다. 무료판이 기능 전부를 담고, 폰·태블릿 연결이 필요하면 월 12달러(연 99달러) 유료판을 쓴다.

1인기업 실전 적용 포인트

• 긴 작업은 폰으로 지켜본다. 배포·크롤링·일괄 변환처럼 10분 넘게 도는 잡을 걸어두고 자리를 뜬 뒤, 실패 지점에서만 폰으로 개입하면 대기 시간이 통째로 사라진다.
• 고정 블록을 운영 계기판으로 쓴다. 오늘 발행 건수, 큐 적체, 이번 달 토큰 비용을 한 번 고정해 두면 매번 다시 물어볼 필요가 없다.
• 비용 표시를 근거 자료로 남긴다. 잡별 토큰·비용이 화면에 뜨므로, 자동화 한 건의 단가를 실측해 견적과 요금제 설계에 그대로 쓸 수 있다.
• 민감한 자료를 다루는 작업은 로컬 모델 세션으로 분리한다. 고객 명단이나 계약서가 섞이는 작업만 별도 세션으로 떼면 외부 전송 자체가 발생하지 않는다.

전망 / 주의점

제작사도 밝히듯 클로드나 제미나이 구독 계정으로는 구동할 수 없다. 약관이 구독 로그인 우회를 금지하기 때문이며, 결국 API 키 또는 로컬 모델이 필요하다. 구독 요금만 내고 쓰던 사람에게는 비용 구조가 달라진다는 뜻이다.

에이전트가 만든 화면 코드를 실제로 실행한다는 점도 짚어야 한다. 격리 프레임이 방어선이지만, 에이전트가 그린 화면을 실행한다는 것 자체가 이전에 없던 공격면을 하나 여는 일이다. 공개 직후인 초기 프로젝트인 만큼, 핵심 저장소를 다루는 작업보다는 실험용 폴더에서 먼저 굴려보고 판단하는 편이 안전하다.

출처: 미라폴드 (https://mirafold.com/)