amenbo

amenbo 2.0.0 — 플러그인: 태스크가 움직이면 내가 만든 프로그램이 돌아갑니다

플러그인을 설치하면 태스크에 무슨 일이 생길 때 그것이 돌아갑니다. 팀은 자기 카탈로그로 플러그인을 배포할 수 있습니다. CLI에서는 이제 모든 명령에 `--actor`를 써야 합니다.

이번 릴리스부터 태스크에 무슨 일이 생기면 직접 만든 프로그램을 돌릴 수 있습니다. CLI를 부르는 방식도 하나 바뀌어, 전에 되던 명령이 이제 거부됩니다. 올리기 전에 “업데이트에 대하여”를 읽어 주세요.

플러그인

  • 태스크 이벤트가 내 프로그램을 부릅니다 — 태스크가 완료될 때, 상태가 바뀔 때, 댓글이 달릴 때 플러그인이 돌아갑니다. amenbo plugin run <name>으로 직접 돌릴 수도 있습니다.
  • “마켓” 화면에서, 또는 명령줄에서 설치합니다 — GUI의 “마켓” 화면에서 공식 카탈로그의 것을 고르거나, amenbo plugin install <name>을 실행합니다. 지금은 항목이 하나 있습니다. 태스크마다 git worktree를 잘라 주는 worktree입니다.
  • 설치는 켜는 것이 아닙니다 — 켜는 것은 따로, amenbo plugin enable <name>입니다. 그 스위치가 프로젝트 단위인지 기기 단위인지는 플러그인 작성자가 정합니다.
  • 무엇이 들어오기 전에 서명과 체크섬을 확인합니다 — 확인되지 않는 것은 설치되지 않습니다.
  • 플러그인은 그냥 실행 파일입니다 — 어떤 언어로 써도 됩니다. amenbo가 그것을 자식 프로세스로 띄우고 표준 입력으로 JSON을 건넵니다. 플러그인 만들기를 보세요.

무엇을 읽고, 설정하고, 확인할 수 있는지

  • 줄을 열면 무엇을 받게 되는지 보입니다 — 설치하기 전에, 어떤 이벤트가 이 플러그인을 부르고 들어온 뒤 무엇을 설정해야 하는지 상세가 알려 줍니다.
  • 설정은 하나의 폼입니다 — 작성자가 매니페스트에 선언한 필드가 폼이 됩니다. 비밀 필드는 가려지고, 프로젝트는 필요한 값을 덮어쓸 수 있습니다.
  • amenbo plugin log — 최근 실행들과 그 출력, 종료 코드입니다. 플러그인이 기대한 대로 하지 않았을 때 볼 곳입니다.

내 카탈로그로 플러그인을 배포하기

  • 카탈로그를 등록하면 그 플러그인이 공식 것 옆에 놓입니다amenbo plugin catalog add <catalog.json의 URL> --name "Team catalog", 그러면 같은 목록에 나타나 바로 설치할 수 있습니다. 사내 플러그인을 공식 카탈로그를 거치지 않고 배포할 수 있습니다.
  • 카탈로그는 정적 파일 세 개입니다 — 돌려야 할 서버 프로세스가 없습니다. 카탈로그 운영하기를 보세요.
  • 등록할 때 서명 키를 고정합니다 — 등록하면 그 카탈로그가 공개한 키의 지문을 보여 주고, 동의하면 그것을 고정합니다. 그 뒤로 그 카탈로그에서 설치한 플러그인은 그 키로 검증합니다. 키가 바뀐 카탈로그는 거부되고, 키를 공개하지 않는 카탈로그는 둘러보기만 할 수 있습니다.
  • 모든 줄이 자기 카탈로그의 이름을 답니다 — 그리고 목록은 출처로 거를 수 있습니다. “공식” 표시는 공식 카탈로그의 항목에만 붙습니다. 서드파티 카탈로그가 스스로 공식이라 주장해도 그 표시는 받지 못합니다.
  • 설치된 플러그인은 자기가 어디서 왔는지 기억합니다 — 업데이트를 그 카탈로그에서 가져오므로, 다른 카탈로그의 같은 이름을 잘못 집는 일이 없습니다.

이번 릴리스에 더

  • GUI에서 결정 기록을 거부합니다 — 이유를 적고 거기서 거부합니다. 그러려고 CLI로 옮겨 갈 필요가 없습니다.
  • 효과가 없던 설정 두 개가 이제 효과를 냅니다 — 실행할 때 열리는 뷰인 default_view와, 날짜 쓰는 방식인 date_locale입니다.
  • 태스크를 만들면서 분류합니다amenbo task add --dim <axis>=<value>. amenbo task show도 태스크의 분류를 함께 찍습니다.

업데이트에 대하여

  • 저장소를 건드리는 모든 CLI 명령에 --actor가 필요합니다 — 전에는 AMENBO_ACTOR 환경 변수에서 채워지거나, 아무것도 쓰지 않으면 기본값이 들어갔습니다. 이번 릴리스부터는 매번 씁니다. 사람이 칠 때는 --actor human, AI가 칠 때는 --actor ai입니다. 예를 들어 amenbo task list --actor human. 환경 변수로 설정해 두었다면 명령 쪽으로 옮겨 주세요. amenbo가 놓는 AGENTS.mdCLAUDE.md에도 이제 --actor ai가 분명히 적힙니다. GUI에서는 달라지는 것이 없습니다.
  • 저장 데이터 형식이 올라갑니다 — 이 버전에서 처음 실행할 때 마이그레이션되고, 마이그레이션 전의 백업이 자동으로 남습니다. 한 번 올라가면 예전 버전으로는 열 수 없습니다. GUI와 CLI는 같은 설치 프로그램이 함께 올려 주므로, 한쪽만 옛 버전으로 두지 마세요.

받는 곳

최신 릴리스에서 쓰는 OS의 설치 프로그램을 여세요. GUI와 CLI가 함께 오고, 관리자 권한은 필요 없습니다.

  • macOS — .pkg, Apple 실리콘용과 Intel용 각각 하나씩(첫 실행 때 Gatekeeper 안내가 뜹니다: 우클릭 → “열기”)
  • Windows — setup .exe
  • Linux — .deb / .rpm

업데이트하려면: GUI에서는 “새 버전이 있습니다” 배너가 이제 그 자리에서 적용합니다. CLI만 설치했다면 amenbo update --apply가 바꿔 줍니다.

처음이신가요? 시작하기를 보세요.