UX 개발 / Hermes Agent

Hermes CLI 에이전트 설정과 대시보드: 업무별 프로필로 반복 작업 줄이기

hermes-agentcliprofilesskillsdashboardworkflow

설정 패널의 저장된 작업 방식이 자료 조사·회의 정리·코드 검토용 작업 공간과 보고서에 적용되는 개념 일러스트

Hermes에게 매번 역할과 출력 형식을 설명하고 있다면 업무별 설정을 남겨 보세요. CLI에서 프로필과 Skills를 구성하는 방법, 반복 설명과 검토 부담을 줄이는 이점, 기본 대시보드 사용법과 필요한 경우 맞춤 관리 화면을 구현하는 방법을 안내합니다.

Hermes Agent 공식 웹사이트의 Hermes는 도구를 사용해 일하는 에이전트 실행 환경입니다. CLI는 터미널에서 명령과 대화로 이를 사용하는 방식입니다. 업무별 프로필은 작업 책상, Skills는 그 책상에서 재사용하는 작업 절차라고 생각하면 이해하기 쉽습니다.

이 글은 2026년 10월 25일 공식 문서와 공개 예제를 기준으로 합니다. 아래 구성은 독자가 따라 해 볼 수 있도록 설계한 예제이며, 실제 계정으로 전체 업무를 실행해 측정한 후기는 아닙니다. 설치부터 필요한 경우에는 기존 Hermes 자동화 입문 글을 함께 참고하세요.

1. 에이전트 설정으로 어떤 일이 줄어들까

설정의 목적은 “직원 역할의 AI를 많이 만드는 것”보다 매번 반복되는 설명과 판단 기준을 저장하는 것에 있습니다.

반복되는 불편남겨 둘 설정기대할 수 있는 이점
매번 역할·말투·주의사항 설명SOUL.md요청을 짧게 시작하고 지시 누락 줄이기
회의 요약의 형식이 매번 바뀜meeting-digest Skill같은 항목으로 검토하고 비교하기
개인 취향과 업무 맥락이 섞임업무별 profile메모리·세션·설정을 나눠 혼선 줄이기
간단한 일에도 비싼 모델 사용업무별 모델과 도구 설정작업 난도에 맞는 비용·속도 선택
여러 역할의 상태를 터미널마다 확인기본 대시보드설정과 실행 기록을 한 화면에서 확인

이것은 기대 효과이지 보장된 절감률이 아닙니다. 지침이 지나치게 길거나 역할이 중복되면 관리할 일이 늘어납니다. 먼저 자주 반복하는 업무 하나만 선택하세요.

2. profile, 역할, Skill, 서브에이전트를 구분하자

개념쉬운 설명예
profile설정과 상태를 보관하는 독립 작업 공간회의 정리용 office-notes
agent그 설정을 이용해 현재 일하는 실행 주체지금 회의록을 정리하는 Hermes
SOUL.md계속 유지할 역할과 판단 원칙결정과 제안을 구분하는 보조자
Skill필요할 때 불러오는 작업 절차입력 읽기 → 결정 분류 → 표 작성
subagent한 작업 중 일부를 맡는 자식 실행자료 A와 B를 각각 조사하는 작업자

프로필을 두 개 만든다고 둘이 자동으로 대화하거나 동시에 일하지는 않습니다. 프로필 선택은 어떤 설정으로 일할지, 위임은 현재 작업을 어떻게 나눌지에 관한 기능입니다. 공식 프로필 안내

3. 어떤 파일에 무엇을 적을까

기본 작업 공간은 ~/.hermes/이며, 이름 있는 프로필은 보통 ~/.hermes/profiles/<name>/에 있습니다.

Hermes 공식 문서의 디렉터리 구조에 config.yaml, 인증 파일, SOUL.md, memories, skills와 세션 폴더가 구분되어 있다

공식 공개 설정 문서의 파일 구조 캡처. (출처: Hermes 설정, 2026-10-25 캡처)

config.yaml에는 모델·도구·실행 설정을, .env에는 API 키 같은 비밀값을 둡니다. SOUL.md에는 지속할 역할을, skills/에는 반복 절차를 둡니다. memories/는 선별된 선호와 환경 정보를 유지하는 곳이며 모든 업무 원문을 저장하는 무제한 지식 창고는 아닙니다. 공식 메모리 안내

SOUL.md는 현재 폴더가 아니라 선택한 Hermes 홈에서 읽습니다. 업무 폴더에 같은 이름의 파일만 만들어도 적용될 것이라고 생각하면 혼동하기 쉽습니다. 역할 지침은 모델에게 주는 지시이며, 파일 접근을 막는 운영체제 권한이나 보안 격리와는 다릅니다. 공식 역할 설정 안내

4. CLI에서 업무 프로필 하나 만들기

설치와 모델 연결이 가능한 환경에서 다음 명령을 실행합니다. 이미 같은 이름의 프로필이 있다면 새 이름을 사용하세요. 아래 예제는 기존 기억과 키를 복사하지 않는 새 프로필로 시작합니다.

hermes --version
hermes profile list
hermes profile create office-notes
hermes -p office-notes setup
hermes -p office-notes config check
hermes -p office-notes tools
hermes -p office-notes chat

setup에서 사용할 모델 공급자와 인증을 정하고, tools에서 회의록 읽기와 결과 저장에 필요한 도구를 고릅니다. 모델 연결이 되었다고 검색이나 파일 작업에 필요한 도구까지 모두 동작하는 것은 아닙니다. 간단한 입력 파일을 읽고 짧은 결과를 만드는 것부터 확인합니다. 공식 도구 안내

공식 프로필 빠른 시작 예제에서 프로필 생성, setup, chat이 차례로 실행된다

Hermes 공식 공개 문서의 프로필 생성 예제. 본문의 -p office-notes는 대상 프로필을 명시하는 사용법입니다. (출처: 프로필 빠른 시작, 2026-10-25 캡처)

프로필별 설정을 확인하거나 고칠 때도 대상을 명시합니다.

hermes -p office-notes config
hermes -p office-notes config edit

같은 Hermes 홈을 두 독립 에이전트 프로세스의 공용 상태 저장소로 쓰지 마세요. 공식 문서는 메모리 쓰기가 섞이지 않도록 각 에이전트에 별도 프로필을 주라고 안내합니다. 프로필은 상태를 분리하지만 같은 PC의 파일 접근까지 자동으로 격리하지는 않습니다.

5. 역할은 짧고 구체적으로 적기

새 프로필의 ~/.hermes/profiles/office-notes/SOUL.md를 열어 기본 내용을 확인한 뒤 목적에 맞게 편집합니다. 다음은 역할 지침 예제입니다.

# Office Notes Assistant

Turn meeting notes into a reviewable work summary.
Use the user's language.
Distinguish confirmed decisions from proposals and questions.
Never invent owners, dates, or approvals.
Cite the source file and location for each action item.
Write new reports only in the requested reports directory.
Do not overwrite originals or send messages externally.
If evidence is missing, state what needs confirmation.

“유능한 비서처럼 행동해”보다 “담당자와 기한을 추측하지 말라”가 결과를 검토하기 쉽습니다. 하지만 지침만으로 도구 권한을 제한했다고 생각하면 안 됩니다. 파일·터미널·연결 도구는 실제 필요한 범위로 설정하고, 중요한 원본 대신 승인된 사본으로 먼저 연습합니다.

수정한 역할을 적용해 시험할 때는 새 세션으로 시작합니다. 현재 CLI의 재개된 세션은 생성 시점의 일부 설정을 유지하므로, 설정을 고친 뒤 기존 세션만 계속 보면서 적용 여부를 판단하지 않습니다. 공식 CLI 안내

6. 반복 절차는 Skill로 저장하고 미리 불러오기

다음 폴더를 만들고 SKILL.md 파일을 저장합니다. 같은 파일이 있다면 덮어쓰지 말고 먼저 내용을 확인합니다.

mkdir -p "$HOME/.hermes/profiles/office-notes/skills/meeting-digest"

파일 경로는 ~/.hermes/profiles/office-notes/skills/meeting-digest/SKILL.md입니다.

---
name: meeting-digest
description: Convert meeting notes into decisions, action items, and open questions with source references.
---

# Meeting Digest

1. Read the input files explicitly named by the user.
2. Separate confirmed decisions, proposals, and unresolved questions.
3. For actions, report task, owner, due date, and source location.
4. Mark absent owners and dates as unspecified.
5. Return sections: Decisions, Actions, Open Questions, Sources.
6. Write only to the requested new output path; never overwrite.
7. Check every action against its cited source before finishing.

새 세션을 열 때 -s로 이 절차를 명시적으로 불러옵니다.

hermes -p office-notes chat -s meeting-digest

SOUL.md가 계속 유지할 역할이라면 Skill은 이번에 적용할 작업 순서입니다. 필요한 절차만 불러오면 모든 상세 지침을 매번 대화에 붙일 필요가 줄어듭니다. 공식 Skills 안내

연습 폴더에 회의 메모 사본을 넣고 다음처럼 요청합니다.

inbox/meeting.md를 meeting-digest 절차로 정리해 줘. 결과는 reports/meeting-summary.md에 새 파일로 작성해 줘. 이미 있으면 시각을 붙인 새 경로를 사용해 줘. 제안은 결정으로 바꾸지 말고, 명시되지 않은 담당자·기한은 미지정으로 표시해 줘.

완료 후 원문과 대조합니다. 제안이 확정 사항으로 바뀌지 않았는지, 담당자와 기한이 실제로 있는지, 근거 위치로 돌아갈 수 있는지 확인합니다. 도구 부족·파일 경로 오류부터 해결한 뒤 절차를 확장합니다.

7. 어떤 업무에 적용할 수 있을까

업무역할과 절차를 나누는 방법줄어들 수 있는 반복
회의 정리확정·제안 구분 역할 + 회의 요약 Skill형식 재지정, 누락된 담당자 재확인
자료 조사출처 확인 역할 + 비교표 Skill같은 출처 기준과 표 형식 설명
코드 사전 검토프로젝트 검토 역할 + 경로·근거 중심 Skill리뷰 기준 전달, 모호한 지적 확인

자료 조사에는 검색·페이지 읽기 도구가, 코드 검토에는 저장소와 필요한 검사 환경이 있어야 합니다. 설정 파일만으로 외부 자료나 회사 시스템 접근 권한이 생기지는 않습니다.

한 번의 조사 안에서 독립된 질문이 많아지면 delegate_task를 통한 자식 작업을 고려합니다. 이것은 터미널에 그대로 입력하는 셸 명령이 아니라 에이전트가 호출하는 도구입니다.

두 자료를 독립된 서브에이전트로 조사해 줘. 각자 공식 출처와 확인 날짜, 사실과 불확실한 항목을 반환하게 해 줘. 결과가 모두 도착하면 차이와 근거를 검토해 비교표로 정리해 줘. 원본 수정과 외부 발송은 하지 마.

자식은 새 대화에서 일하므로 목표와 필요한 맥락을 전달해야 합니다. 별도 프로필이 자동 생성되는 것은 아니며, 기본 위임에서는 부모의 활성 도구를 상속하되 일부 도구는 제외됩니다. 여러 모델 호출로 총사용량이 늘 수 있습니다. 공식 위임 안내

8. OpenClaw 같은 대시보드가 Hermes에도 있을까

있습니다. 직접 만들기 전에 기본 웹 대시보드를 실행해 보세요. OpenClaw 공식 웹사이트와 Control UI 문서가 브라우저 관리 화면을 안내하듯, Hermes도 공식 웹 대시보드를 제공합니다. 두 제품의 기능이 모두 같다는 뜻은 아닙니다.

hermes dashboard
# To leave browser opening to yourself:
# hermes dashboard --no-open

기본 주소는 http://127.0.0.1:9119입니다. 설치 상태에 따라 첫 실행에서 화면 빌드나 의존성 안내가 나올 수 있습니다. 안내된 준비를 마친 뒤 다시 실행합니다.

Hermes 공식 대시보드의 Config 화면에서 왼쪽 설정 분류와 오른쪽 설정 편집 항목을 볼 수 있다

Hermes 공식 공개 문서에 제공된 대시보드 Config 화면. 설치 버전에 따라 화면이 다를 수 있으며, 작은 화면에서는 눌러 확대할 수 있습니다. (출처: Hermes Web Dashboard)

확인할 화면업무에서 하는 일
Profiles와 프로필 선택기업무별 설정을 골라 대상 혼동 줄이기
Config·Models·Skills모델·설정·반복 절차 관리
Sessions·Logs·Analytics실행 내용, 오류, 사용량 점검
Cron예약 작업과 실행 상태 확인
Chat브라우저 안에서 TUI 대화 사용

현재 공식 문서상 하나의 대시보드가 같은 PC의 여러 프로필을 관리합니다. 사이드바의 프로필 선택기가 설정 페이지의 읽기·쓰기 대상을 바꿉니다. 선택한 프로필과 기본 활성 프로필 변경은 구분하세요. 프로필을 바꿔 보이는 화면을 전환하는 것과 이후 CLI 실행의 기본값을 바꾸는 일은 다릅니다. 공식 대시보드 안내

대시보드가 로컬에서 열린다는 사실과 모델 처리가 로컬이라는 사실도 별개입니다. 원격 모델이나 외부 도구를 선택하면 해당 연결로 데이터가 전송될 수 있습니다. 원격 접속을 구성한다면 공식 인증 방식을 적용하고 관리 화면을 인증 없이 공개하지 않습니다.

9. 에이전트 관리용 대시보드를 직접 만드는 것이 일반적일까

관리 UI를 제공하는 것은 두 제품에서 확인되지만, 사용자가 직접 새로 제작하는 것이 보편적이라고 단정할 근거는 확인하지 못했습니다. Hermes는 기본 관리 화면과 공식 확장 지점을 제공하므로 다음 순서로 판단하는 편이 실용적입니다.

  1. 프로필·설정·세션 관리면 기본 대시보드를 사용합니다.
  2. 사내 보고서 링크나 특정 업무 현황만 더 필요하면 맞춤 탭을 추가합니다.
  3. 조직의 사용자 권한, 승인 흐름, 여러 서버의 통합 관리가 필요하면 별도 웹앱과 백엔드를 설계합니다.

화면을 만든다고 자동으로 팀원별 접근 통제나 승인 기록이 생기지는 않습니다. 관리 대상으로 삼을 에이전트, 실행 상태, 결과 위치, 허용할 조작부터 정해야 합니다.

10. 작게 구현하기: 기본 대시보드에 업무 탭 추가

Hermes에는 웹 대시보드용 테마, UI 플러그인, 백엔드 플러그인 확장 방식이 있습니다. 단순 탭을 추가할 때 코어 저장소를 복제해 수정할 필요는 없습니다. 아래는 현재 공식 SDK 형식에 맞춘 최소 예제로, 설치 버전에서의 전체 실행은 별도로 확인해야 합니다. 공식 대시보드 확장 안내

기본 프로필에 설치하는 예제입니다. 다음 폴더와 두 파일을 만듭니다.

mkdir -p "$HOME/.hermes/plugins/work-overview/dashboard/dist"

~/.hermes/plugins/work-overview/dashboard/manifest.json:

{
  "name": "work-overview",
  "label": "Work Overview",
  "version": "1.0.0",
  "tab": { "path": "/work-overview", "position": "after:skills" },
  "entry": "dist/index.js"
}

~/.hermes/plugins/work-overview/dashboard/dist/index.js:

(function () {
  "use strict";
  const SDK = window.__HERMES_PLUGIN_SDK__;
  const React = SDK.React;

  function WorkOverview() {
    const [version, setVersion] = React.useState("Loading...");
    React.useEffect(function () {
      let active = true;
      SDK.api.getStatus()
        .then(function (status) {
          if (active) setVersion(String(status.version));
        })
        .catch(function () {
          if (active) setVersion("Status unavailable");
        });
      return function () { active = false; };
    }, []);

    return React.createElement("section", null,
      React.createElement("h2", null, "Work Overview"),
      React.createElement("p", null, "Hermes version: " + version),
      React.createElement("a", { href: "/profiles" }, "Profiles"),
      React.createElement("span", null, " | "),
      React.createElement("a", { href: "/sessions" }, "Sessions")
    );
  }
  window.__HERMES_PLUGINS__.register("work-overview", WorkOverview);
})();

파일을 추가한 뒤 hermes dashboard를 다시 시작하고 페이지를 새로 고칩니다. 새 탭이 나타나는지, 버전을 불러오는지, 실패할 때 오류를 표시하는지 확인합니다. 이 예제는 상태 읽기와 기존 관리 페이지로 이동하는 입구입니다. 프로필 생성이나 실행 중지 기능까지 구현한 예제는 아닙니다.

업무 데이터를 표시하려면 공식 방식의 dashboard/plugin_api.py에 읽기 API를 추가하고 UI에서 SDK.fetchJSON으로 호출하는 설계로 확장할 수 있습니다. 대상 프로필과 권한, 읽을 수 있는 출력 파일 범위는 백엔드에서 확인합니다. Web Dashboard와 네이티브 Desktop의 플러그인 SDK는 서로 다릅니다.

11. 별도 업무 시스템에 연결하려면 API를 사용한다

독립적인 사내 화면이 필요하다면 Hermes의 공식 API Server를 후보로 삼습니다. 관리용 Web Dashboard의 기본 포트 9119와 API Server의 기본 포트 8642는 다릅니다. OpenAI 호환 채팅 API를 제공한다고 모든 관리 작업도 그 API로 할 수 있다는 뜻은 아닙니다.

다음은 기본 프로필의 .env에 추가하는 예제입니다. 키는 직접 생성한 긴 무작위 값으로 바꾸고 공개할 코드에는 저장하지 않습니다. 이름 있는 프로필이라면 해당 프로필의 .env와 실행 대상을 맞춥니다.

API_SERVER_ENABLED=true
API_SERVER_KEY=replace-with-a-long-random-secret
hermes gateway

별도 터미널에서 같은 키를 환경 변수 HERMES_API_KEY로 설정한 뒤 연결을 확인합니다.

curl --fail-with-body http://127.0.0.1:8642/v1/chat/completions \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hermes-agent","messages":[{"role":"user","content":"Reply with ready only."}]}'

이것은 연결 확인이며 완성된 에이전트 관리 화면은 아닙니다. 자체 구현은 다음 구조로 나누면 역할을 정리하기 쉽습니다.

Browser: choose task, view progress, review result
  -> Your backend: login, allowed profiles/tasks, audit records
    -> Hermes API Server: create run, read status, stop run
      -> Selected agent environment: model, tools, skills

긴 작업에는 POST /v1/runs, 상태 조회에는 GET /v1/runs/{run_id}, 중지에는 POST /v1/runs/{run_id}/stop이 제공됩니다. 화면은 시작 요청 접수를 완료로 처리하지 않고 실패·중단·결과 불명 상태도 표시합니다. 구현 전 GET /v1/capabilities로 대상 버전의 기능을 확인합니다. 공식 API Server 문서

API 키는 브라우저에 넣지 않고 자체 백엔드에 둡니다. 프로필 이름이나 임의 명령을 그대로 실행에 넘기지 않고 서버의 허용된 대상으로 대응시킵니다. 여러 프로필·호스트를 통합할 때는 어느 인증된 엔드포인트로 보낼지도 백엔드에서 관리합니다. 기존 CLI 세션 ID만 넘기면 그 대화를 자유롭게 조작할 수 있다고 가정하지 않습니다.

12. 첫 성공 기준은 다음에도 같은 절차로 쓸 수 있는가다

먼저 프로필 하나, Skill 하나, 입력 예제 하나로 시험합니다. 역할과 절차를 설정하기 전후로 설명을 다시 쓴 횟수, 확인에 걸린 시간, 담당자·날짜 오류, 모델과 도구 사용량을 기록합니다.

원문에 근거한 결과가 기대한 형식으로 반복해서 나온다면 다른 업무로 넓힙니다. 일간·주간 자동 실행이 필요해졌을 때 예약 실행 실전 예제를 추가합니다. Claude Code의 분업과 비교하려면 에이전트와 서브에이전트 해설도 참고하세요.

설정을 저장해 반복 사용하고, 기본 대시보드에서 상태를 확인한 뒤, 부족한 화면을 더합니다. 이 순서로 시작하면 에이전트 수를 늘리기 전에 자신의 업무에서 효과가 있는 구성을 확인할 수 있습니다.

Related