데몬과 런타임

Melso는 작업을 기록하고 조율하며 연결된 컴퓨터가 실행을 담당합니다. 컴퓨터의 데몬(daemon)이 태스크를 가져간 뒤 로컬에 설치된 AI 코딩 도구를 호출합니다.

개념 구분

• 데몬은 한 컴퓨터에서 실행되는 Melso 백그라운드 프로그램입니다. 서버 연결, 로컬 도구 검색, 태스크 수령, 결과 반환을 담당합니다.
• 런타임은 워크스페이스가 사용할 수 있는 구체적인 실행 환경을 나타냅니다. 컴퓨터 한 대와 그 컴퓨터의 AI 코딩 도구 하나 또는 사용자 지정 런타임 설정의 조합입니다.

예를 들어 한 컴퓨터에 Claude Code와 Codex가 모두 설치되어 있고 두 워크스페이스에 연결되어 있다면 데몬이 각 워크스페이스에 Claude Code와 Codex 런타임을 각각 등록합니다. 데몬을 다시 시작하면 기존 기록이 업데이트되며 같은 조합의 런타임이 계속 새로 생기지 않습니다.

실행 위치와 데이터 경계

로컬 런타임이 호출하는 AI 코딩 도구, 도구 자체의 로그인 자격 증명, 로컬 코드 디렉터리는 연결된 컴퓨터에 남습니다. Melso 서버가 로컬 도구를 대신해 명령을 실행하거나 전체 작업 디렉터리를 자동으로 업로드하지 않습니다.

팀 협업을 위해 서버에는 이슈, 댓글, 에이전트 설정, 태스크 컨텍스트, 실행 기록, 에이전트가 반환한 결과가 저장됩니다. 이 내용에는 에이전트가 직접 읽고 답변에 포함한 코드 조각이나 다른 프로젝트 컨텍스트가 들어갈 수 있습니다.

데몬 시작

Melso Desktop을 사용하면 앱이 데몬을 자동으로 시작하므로 별도 명령을 실행할 필요가 없습니다.

Web, 원격 컴퓨터, 화면 없는 환경에서는 먼저 Melso CLI를 설치한 뒤 다음을 실행합니다.

melso daemon start

데몬은 기본적으로 백그라운드에서 실행됩니다. 자주 사용하는 명령은 다음과 같습니다.

태스크 작업 디렉터리를 다른 디스크에 두려면 melso config set workspaces_root <path>로 현재 profile의 루트를 저장하거나 daemon start 또는 daemon restart에 --workspaces-root <path>를 전달합니다. flag는 MULTICA_WORKSPACES_ROOT보다 우선하고, 환경 변수는 profile 설정보다 우선합니다. 루트를 변경해도 기존 태스크 디렉터리는 이동되지 않습니다.

시작할 때 데몬은 PATH에서 지원되는 AI 코딩 도구를 감지하고 사용자가 연결할 권한이 있는 워크스페이스에 런타임을 등록합니다. 도구를 방금 설치하거나 로그인했다면 데몬을 다시 시작해 다시 감지할 수 있습니다.

데몬을 시작하려면 기본 지원 AI 코딩 도구를 하나 이상 감지해야 합니다. 설치 방법과 실행 파일 이름은 AI 코딩 도구 설치를 참고하세요.

디스패치와 온라인 상태

런타임이 등록되면 연결을 계속 유지합니다. 새 태스크가 큐에 들어오면 서버가 해당 데몬에 알리고, 연결이 끊겼을 때를 대비해 데몬도 주기적으로 폴링합니다. 따라서 런타임이 온라인이고 여유 용량이 있으면 태스크는 보통 즉시 시작됩니다.

데몬은 15초마다 heartbeat를 보냅니다. 서버는 heartbeat와 연결 상태를 함께 사용해 런타임의 온라인 여부를 판단합니다. 데몬이 예기치 않게 종료되면 보통 늦어도 약 3분 안에 오프라인으로 표시됩니다.

런타임이 오프라인일 때는 다음과 같이 처리됩니다.

• 이미 큐에 들어간 태스크는 런타임이 복구될 때까지 최대 2시간 기다립니다.
• 실행 중인 태스크는 실패합니다. 조건을 만족하는 이슈 또는 대화 태스크는 자동으로 재시도될 수 있습니다.
• 데몬이 다시 시작되면 런타임을 재등록하고 이전에 정상적으로 끝나지 않은 태스크를 회수합니다.
• 7일 넘게 오프라인이고 연결된 에이전트가 하나도 없는 런타임은 보관된 에이전트까지 확인한 뒤 자동으로 정리됩니다.

자세한 상태와 재시도 규칙은 실행 태스크를 참고하세요.

동시 실행 제한

데몬 한 대는 기본적으로 태스크를 최대 20개까지 동시에 실행하며, 에이전트 한 명은 기본적으로 최대 6개까지 동시에 실행합니다. 실제 동시 실행 수에는 둘 중 더 작은 값이 적용됩니다.

상한에 도달하면 새 태스크는 계속 큐에서 기다립니다. 에이전트 설정에서 개별 에이전트의 동시 실행 수를 조정할 수 있고 MULTICA_DAEMON_MAX_CONCURRENT_TASKS로 컴퓨터 전체 상한을 조정할 수도 있습니다. 병렬 실행은 컴퓨터 성능, 도구 계정 사용량, 같은 작업 디렉터리를 동시에 사용합니다.

비공개와 공개

로컬 런타임의 기본값은 비공개입니다. 그 위에 에이전트를 만들 수 있는 사람은 런타임 owner뿐이며, 워크스페이스 owner와 admin도 예외가 아닙니다. 런타임은 다른 멤버의 컴퓨터이고, 거기서 에이전트를 실행하면 그 멤버의 컴퓨터와 도구 자격 증명을 사용하게 되기 때문입니다.

공개로 바꿀 수 있는 사람은 런타임 owner뿐입니다. 워크스페이스 관리자는 런타임의 이름을 바꾸거나 삭제할 수 있지만, 공유 여부는 owner가 결정합니다. 공개하면 워크스페이스의 다른 멤버도 이 런타임을 선택할 수 있습니다. 기반 AI 코딩 도구의 로그인 자격 증명을 공유하는 것이 아니라 멤버가 에이전트 실행 태스크를 해당 컴퓨터로 라우팅할 수 있게 하는 것입니다.

사용자 지정 런타임 설정

팀에서 내부 wrapper, 고정 버전 실행 파일을 사용하거나 호환 도구에 고정 인수를 추가해야 한다면 사용자 지정 런타임 설정을 만들 수 있습니다.

사용자 지정 설정이 새 통신 프로토콜을 추가하지는 않습니다. 만들 때 Melso가 이미 지원하는 프로토콜 계열 중 하나를 선택해야 하며(도구 연동 프로토콜 유형은 AI 코딩 도구 비교 참고), 명령 자체도 해당 프로토콜과 호환되어야 합니다.

설정 만들기

워크스페이스 owner와 admin만 사용자 지정 런타임 설정을 만들고 수정하거나 삭제할 수 있습니다.

1. 런타임을 열고 해당 명령이 설치된 컴퓨터로 들어갑니다.
2. 사용자 지정 런타임 추가를 클릭합니다.
3. 명령이 실제로 호환되는 프로토콜 계열을 선택합니다.
4. 이름, 명령, 고정 인수를 입력하고 저장합니다.

설정은 워크스페이스에서 공유됩니다. 연결된 각 컴퓨터가 이 명령을 개별적으로 찾으며 PATH에서 명령을 확인할 수 있는 컴퓨터만 해당 런타임을 등록합니다. 설정을 만든다고 명령이 자동으로 설치되거나 다른 멤버의 도구 로그인이 완료되지는 않습니다.

여기에는 shell script가 아니라 실행 파일과 인수를 입력합니다. 일반 인수, 따옴표, 백슬래시 이스케이프는 사용할 수 있지만 파이프, 리디렉션, &&, ;, 역따옴표, 환경 변수 확장은 사용할 수 없습니다. 이런 동작이 필요하면 wrapper script에 넣고 해당 스크립트를 명령으로 입력하세요.

Desktop이 시작한 데몬에서 터미널에서는 실행되는 명령을 찾지 못한다면 현재 컴퓨터에 절대 경로를 설정할 수 있습니다.

melso runtime profile set-path <profile-id> --path /absolute/path/to/command

경로 덮어쓰기를 제거하려면 다음을 실행합니다.

melso runtime profile unset-path <profile-id>

설정 변경은 이후 가져가는 태스크에만 적용됩니다. 설정을 삭제하기 전에 해당 런타임에 계속 연결된 활성 에이전트를 먼저 처리해야 합니다. 특정 컴퓨터의 런타임 인스턴스만 삭제해도 설정은 삭제되지 않으며 실행 중인 데몬이 다시 등록합니다.

런타임 오프라인 문제 해결

다음 순서로 확인하세요.

1. melso daemon status를 실행해 데몬이 시작되었는지 확인합니다.
2. melso daemon logs -f를 실행해 로그인, 네트워크, 도구 감지 오류를 확인합니다.
3. 같은 실행 환경에서 command -v <도구 명령>을 실행해 데몬이 도구를 찾을 수 있는지 확인합니다.
4. Melso의 런타임 페이지를 열고 대상 컴퓨터와 해당 AI 코딩 도구가 온라인으로 표시되는지 확인합니다.
5. 도구를 방금 설치했거나 경로 또는 설정을 변경했다면 melso daemon restart를 실행합니다.

그래도 해결되지 않으면 문제 해결을 참고하세요.

다음 단계

• AI 코딩 도구 설치 — 지원되는 AI 코딩 도구를 설치하고 확인합니다.
• AI 코딩 도구 비교 — 모델, 세션 복원, MCP, 스킬 지원을 비교합니다.
• 실행 태스크 — 큐 대기, 중지, 재시도를 알아봅니다.