Repolode
nikships

nikships/muse-cli

터미널에서 개인 muse.ai AI 에이전트와 채팅하고 사이드 채팅, 피드, 목표, 아이디어, 세션을 관리하는 CLI 클라이언트입니다.

스타
51
포크
20
열린 이슈
1
마지막 커밋
13시간 전

어떤 프로젝트인가요?

muse-cli를 사용하면 브라우저를 열지 않고도 개인 muse.ai 에이전트와 대화할 수 있습니다. 이름이 지정된 하위 명령으로 채팅, 사이드 채팅, 피드, 목표, 아이디어, 세션 관리를 지원하며, raw 명령으로 258개 게이트웨이 메서드에 모두 접근할 수 있습니다. 각 명령은 JSON을 출력하므로 jq, cron 작업이나 다른 스크립트에 출력을 전달할 수 있습니다.

이 도구는 muse.ai 웹 앱과 같은 방식으로 연결됩니다. HTTPS로 인증한 다음 사용자의 개인 VM에 암호화된 Noise-XX WebSocket 연결을 엽니다. 로그인 시 Google Chrome의 쿠키를 재사용하며, agent-browser helper로 쿠키를 한 번 내보내고 제한된 파일 권한으로 로컬에 저장합니다. 액세스 토큰은 명령을 실행할 때마다 새로 가져옵니다.

이 프로젝트는 Python으로 작성되었으며 uv, pipx 또는 pip로 설치할 수 있습니다. 또한 코딩 에이전트가 사용자를 대신해 읽기 전용 muse-cli 명령을 실행할 수 있도록 agent skill을 포함합니다. 내부 API에 버전이 지정되지 않으므로 muse.ai가 변경되면 호출이 작동하지 않을 수 있다고 프로젝트에서 안내합니다.

핵심 기능

  • 01에이전트와 채팅하고 셸에서 응답을 JSON으로 읽을 수 있습니다.
  • 02사이드 채팅 세션을 나열하고, 이름을 변경하고, 고정하고, 보관하고, 삭제할 수 있습니다.
  • 03피드를 읽고 반응을 남기며, 목표와 아이디어를 볼 수 있습니다.
  • 04258개 게이트웨이 메서드에 모두 사용할 수 있는 raw 명령을 실행할 수 있습니다.
  • 05Chrome 쿠키를 재사용해 인증하며, 쿠키는 권한 모드 600으로 로컬에 저장됩니다.
  • 06코딩 에이전트가 대신 명령을 실행할 수 있도록 agent skill을 제공합니다.

활용 사례

  • 에이전트 응답을 셸 스크립트나 jq 파이프라인에 전달하기.
  • cron으로 에이전트 쿼리를 정기 실행하기.
  • 코딩 에이전트가 터미널에서 상태와 목표를 확인하게 하기.
  • 터미널 기반 또는 스크린 리더 친화적인 채팅 인터페이스로 사용하기.

빠른 시작

  1. 1

    uv로 CLI를 설치합니다

    uv tool install muse-cli
  2. 2

    npm에서 cookie reader를 설치합니다(Node.js 필요)

    npm i -g agent-browser
  3. 3

    Chrome에서 원격 디버깅을 켜고 muse.ai에 로그인한 다음 로그인 정보를 저장합니다

  4. 4

    연결을 확인합니다

    muse-cli status

사용 전 알아둘 점

  • Google Chrome에서 가져온 브라우저 쿠키와 변경될 수 있는 버전 관리되지 않는 muse.ai 내부 API에 의존합니다.
  • muse.ai 계정과 개인 VM이 필요합니다. 쿠키는 만료되므로 로그인 단계를 반복해야 합니다.
  • 가장 간편한 로그인 방법을 사용하려면 Chrome 원격 디버깅 설정과 agent-browser가 필요합니다.

토픽

자주 묻는 질문

muse-cli은(는) 무엇인가요?
터미널에서 개인 muse.ai AI 에이전트와 채팅하고 사이드 채팅, 피드, 목표, 아이디어, 세션을 관리하는 CLI 클라이언트입니다. muse-cli를 사용하면 브라우저를 열지 않고도 개인 muse.ai 에이전트와 대화할 수 있습니다. 이름이 지정된 하위 명령으로 채팅, 사이드 채팅, 피드, 목표, 아이디어, 세션 관리를 지원하며, raw 명령으로 258개 게이트웨이 메서드에 모두 접근할 수 있습니다. 각 명령은 JSON을 출력하므로 jq, cron 작업이나 다른 스크립트에 출력을 전달할 수 있습니다.
muse-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
muse-cli은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
muse-cli은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. muse-cli의 마지막 커밋은 2026년 10월 22일입니다.
muse-cli은(는) 어디에 사용할 수 있나요?
에이전트 응답을 셸 스크립트나 jq 파이프라인에 전달하기. cron으로 에이전트 쿼리를 정기 실행하기. 코딩 에이전트가 터미널에서 상태와 목표를 확인하게 하기. 터미널 기반 또는 스크린 리더 친화적인 채팅 인터페이스로 사용하기.
muse-cli는 어떻게 설치하나요?
uv로 CLI를 설치합니다: uv tool install muse-cli npm에서 cookie reader를 설치합니다(Node.js 필요): npm i -g agent-browser Chrome에서 원격 디버깅을 켜고 muse.ai에 로그인한 다음 로그인 정보를 저장합니다 연결을 확인합니다: muse-cli status
muse-cli은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nikships/muse-cli

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트