OpenLog 시작하기: CLI와 에이전트 연결하기

OpenLog는 웹에서 직접 기록할 수도 있지만, 코딩 에이전트와 연결했을 때 작업 흐름에 더 자연스럽게 들어옵니다.

CLI와 MCP 서버를 연결하면 에이전트가 현재 작업과 관련된 Task, Log, Memory를 조회하고 정리할 수 있습니다. 작업이 끝난 뒤 기억을 되짚어 문서를 작성하기보다, 작업하는 동안 필요한 맥락을 바로 남길 수 있습니다.

이 글에서는 OpenLog 계정을 준비하고 코딩 에이전트에서 첫 세션을 시작하는 과정까지 살펴봅니다.

시작하기 전에

공식 CLI를 사용하려면 Node.js 20 이상이 필요합니다.

먼저 openlog.kr에 로그인하고 워크스페이스를 하나 만들어 주세요. 워크스페이스는 프로젝트와 작업 기록을 모아두는 공간입니다.

CLI 설정 시작하기

터미널에서 다음 명령을 실행합니다.

npx -y @openloghq/cli@latest

대화형 설정 화면이 열리면 다음 과정을 차례로 진행합니다.

1. OpenLog 로그인
2. 연결할 코딩 에이전트 선택
3. MCP 권한 설정

로그인이 필요하면 CLI가 Device Login을 시작합니다. 터미널에 표시된 안내에 따라 브라우저에서 로그인 요청을 승인하면 됩니다. 계정 비밀번호나 인증 정보를 MCP 설정 파일에 직접 넣을 필요는 없습니다.

연결할 수 있는 클라이언트는 다음과 같습니다.

• Codex
• Claude Code
• Cursor

하나만 선택할 수도 있고, 사용 중인 클라이언트를 한 번에 모두 연결할 수도 있습니다.

설정 화면을 다시 열고 싶을 때는 다음 명령을 사용합니다.

npx -y @openloghq/cli@latest setup

MCP 권한 선택하기

설정 과정에서는 코딩 에이전트가 로컬에서 사용할 수 있는 OpenLog 도구의 범위를 선택합니다.

처음에는 기본값인 safe-write를 권장합니다.

• read-only: OpenLog의 계정과 문서를 조회할 수 있습니다.
• safe-write: 문서를 조회하고 생성하거나 수정할 수 있습니다.
• full: 문서 삭제와 Working Brief 초기화 기능까지 사용할 수 있습니다.

safe-write에서도 게시글 발행처럼 공개 상태를 바꾸는 작업은 바로 실행되지 않습니다. 먼저 변경 내용을 보여주고 사용자가 확인해야 실제로 반영됩니다.

권한은 나중에도 변경할 수 있습니다.

openlog mcp permissions
openlog mcp permissions set read-only
openlog mcp permissions set safe-write
openlog mcp permissions set full

권한을 바꿨다면 코딩 에이전트에서 MCP 서버를 다시 불러와 주세요.

프로젝트를 연결하는 두 가지 방법

기본 설정은 로그인과 MCP 등록만 처리합니다. 현재 터미널의 폴더를 자동으로 읽거나 OpenLog 프로젝트에 연결하지는 않습니다.

프로젝트는 두 가지 방식으로 사용할 수 있습니다.

폴더 없이 시작하기

OpenLog에 프로젝트가 하나 있다면 에이전트에게 다음과 같이 요청할 수 있습니다.

내 OpenLog 프로젝트를 찾아서 세션을 시작해 줘.

프로젝트가 여러 개라면 에이전트가 어떤 프로젝트를 사용할지 물어봅니다. 아직 프로젝트가 없다면 새 프로젝트를 만드는 내용을 먼저 보여주고 확인을 요청합니다.

로컬 저장소나 폴더가 준비되지 않은 기획·조사 작업도 이 방식으로 시작할 수 있습니다.

현재 폴더와 연결하기

특정 Git 저장소나 로컬 폴더를 OpenLog 프로젝트와 연결하려면 해당 폴더에서 init을 실행합니다.

cd <프로젝트 폴더>
npx -y @openloghq/cli@latest init

CLI가 현재 위치를 확인한 뒤 연결할 워크스페이스와 프로젝트를 선택하도록 안내합니다.

Git 저장소에서는 .git/config에 OpenLog 프로젝트 ID를 저장합니다. 일반 폴더에서는 .openlog/project.json을 사용합니다. 이 과정에서 폴더 안의 코드나 파일 내용을 읽지는 않습니다.

한 번 연결해 두면 에이전트가 현재 작업 경로를 기준으로 알맞은 OpenLog 프로젝트를 찾을 수 있습니다.

첫 번째 세션 시작하기

설정을 마쳤다면 Codex, Claude Code 또는 Cursor를 다시 실행하고 다음과 같이 요청해 보세요.

OpenLog 연결 상태를 확인하고 이 프로젝트의 세션을 시작해 줘.

세션이 시작되면 에이전트는 연결된 워크스페이스와 프로젝트, 현재 작업 상태를 확인할 수 있습니다.

이제 실제 작업을 진행하며 구체적으로 기록을 요청할 수 있습니다.

지금 해결할 문제를 OpenLog Task로 만들어 줘.

방금 확인한 원인과 수정 방향을 Log로 남겨 줘.

다음 작업에서도 사용할 수 있도록 이 판단을 Memory로 정리해 줘.

처음부터 모든 기능을 사용할 필요는 없습니다. Task 하나를 만들고, 작업하면서 중요한 판단을 Log로 남기는 것부터 시작해도 충분합니다.

에이전트가 언제 기록할지 설정하기

OpenLog를 연결했다고 해서 에이전트가 모든 작업을 자동으로 기록하는 것은 아닙니다. 프로젝트의 Capture Mode와 워크스페이스의 Agent Guide를 통해 언제, 무엇을, 어떤 형식으로 남길지 정할 수 있습니다.

Capture Mode는 프로젝트마다 설정합니다.

처음에는 ASK로 시작해 에이전트가 어떤 내용을 기록하려는지 살펴보는 편이 좋습니다. 기준이 어느 정도 정리되면 AUTO로 바꿔 작업 흐름을 끊지 않고 기록할 수 있습니다.

이 프로젝트의 Capture Mode를 AUTO로 변경해 줘.
변경 내용을 먼저 보여주고 확인 후 반영해 줘.

AUTO는 모든 대화와 변경을 무조건 저장하는 모드가 아닙니다. 에이전트는 Agent Guide에 적힌 기준을 참고해 기록할 만한 작업인지 판단합니다. MCP 권한과 발행·삭제 확인 절차도 그대로 적용됩니다.

Agent Guide로 기록 기준 정하기

Agent Guide는 에이전트가 OpenLog를 사용할 때 따라야 하는 워크스페이스별 지침입니다.

다음과 같은 내용을 정할 수 있습니다.

• 어떤 작업을 Task로 만들지
• 어떤 변경을 Log로 남길지
• FIX, DECISION, ISSUE, NOTE를 구분하는 기준
• Log에 반드시 포함할 항목
• 다시 사용할 판단을 Memory로 옮기는 기준
• 여러 기록을 Output으로 정리하는 시점
• 사소한 변경 중 기록하지 않을 범위

예를 들어 다음과 같이 요청할 수 있습니다.

현재 Agent Guide를 확인하고 다음 기록 규칙을 추가해 줘.

- 단순 포맷 변경이나 import 정리는 Log로 남기지 않는다.
- 버그 수정은 증상, 원인, 변경 내용, 검증 결과를 FIX Log에 기록한다.
- 두 가지 이상의 선택지를 비교했다면 DECISION Log를 작성한다.
- 다른 프로젝트에서도 다시 사용할 수 있는 판단은 Memory 후보로 정리한다.
- 공개 글로 발전시킬 만한 작업만 Output 초안을 만든다.

변경될 내용을 먼저 보여주고 확인 후 반영해 줘.

에이전트는 변경된 Agent Guide를 먼저 보여주고 확인을 받은 뒤 반영합니다. 설정 화면을 찾아가 직접 문서를 편집하지 않아도, 작업 중인 대화에서 바로 기록 정책을 수정할 수 있습니다.

사용하면서 기록 방식을 다듬기

처음부터 완벽한 Agent Guide를 만들 필요는 없습니다.

AUTO로 사용하다 보면 기록이 너무 자주 만들어지거나, 반대로 남았으면 하는 판단이 빠질 수 있습니다. 그럴 때 에이전트에게 현재 기록을 기준으로 Guide를 수정해 달라고 요청하면 됩니다.

최근에는 작은 UI 수정까지 Log로 남고 있어.
사용자 동작이나 데이터 흐름에 영향을 주는 변경만 기록하도록
Agent Guide의 기준을 좁혀 줘.

또는 기록 형식이 부족하다고 느껴질 때도 바로 보완할 수 있습니다.

앞으로 FIX Log에는 재현 조건과 검증 방법을 반드시 포함하도록
Agent Guide를 수정해 줘.

이렇게 작업 → 기록 결과 확인 → Agent Guide 수정 → 다음 작업에 적용하는 과정을 반복하면, 에이전트가 프로젝트에 맞는 기록 습관을 점차 갖게 됩니다.

Guide나 Capture Mode를 변경한 뒤에는 세션을 다시 시작하거나 관련 설정을 다시 읽어 최신 기준이 적용되도록 합니다.

변경된 Agent Guide와 Capture Mode를 다시 읽고
OpenLog 세션을 시작해 줘.

연결 상태를 직접 확인하려면

CLI 로그인 상태는 다음 명령으로 확인할 수 있습니다.

npx -y @openloghq/cli@latest whoami

MCP 등록을 직접 실행하고 싶다면 클라이언트를 지정할 수도 있습니다.

openlog mcp install codex
openlog mcp install claude-code
openlog mcp install cursor

모든 지원 클라이언트에 등록하려면 다음 명령을 사용합니다.

openlog mcp install all

기록을 위한 별도 작업을 만들지 않기

OpenLog를 연결하는 목적은 문서 작성 업무를 하나 더 추가하는 데 있지 않습니다.

평소처럼 코딩 에이전트와 작업하면서 해결해야 할 문제와 중요한 판단을 가까운 곳에 남기는 것이 먼저입니다. 그렇게 쌓인 Task와 Log, Memory는 나중에 Output으로 정리하고 공개 게시글로 발행할 수 있습니다.

첫 연결을 마쳤다면 작은 작업 하나부터 기록해 보세요. 작업이 끝났을 때 코드뿐 아니라 그 코드를 만든 이유도 함께 남아 있을 겁니다.