> 지난 글에서는 터미널 기반 AI 에이전트 **OpenCode**에 대해 알아보았습니다. 하지만 OpenCode 그 자체는 훌륭한 '실행 환경(Runtime)'일 뿐입니다. 실제로 코드를 작성하고, 파일을 찾고, 아키텍처를 고민하는 지능적인 작업은 그 위에서 돌아가는 **'에이전트 프로그램'**이 담당합니다. 오늘은 OpenCode 생태계에서 가장 강력하고 널리 쓰이는 메인 에이전트, **Sisyphus(시지푸스)**에 대해 알아봅니다.

# 1. Sisyphus란 무엇인가?

**Sisyphus**는 **Oh My OpenCode**라는 오케스트레이션 레이어(Orchestration Layer)에 포함된 핵심 에이전트입니다. 그리스 신화에서 바위를 끝없이 밀어 올리는 시지푸스처럼, 개발자의 **무한한 코딩 루프(작성-테스트-수정)** 를 대신 수행해 준다는 의미를 담고 있습니다.

단순히 "코드 짜줘"라고 하면 코드를 뱉는 챗봇이 아닙니다. Sisyphus는 **개발자처럼 생각하고 행동하도록 설계된 시스템**입니다.

# 2. 핵심 철학: "Sisyphus는 혼자 일하지 않는다"

Sisyphus의 가장 큰 특징은 **전문가 에이전트들과 협업**한다는 점입니다. 마치 팀장(Lead Dev)처럼 행동합니다.

### 🧩 The Agent Squad (에이전트 스쿼드)

1. **Sisyphus (Main Agent)**: 사용자의 명령을 듣고 전체 작업을 조율하는 리더.
2. **Librarian**: "이 프로젝트에서 인증 관련 로직이 어디 있지?"라고 물으면 문서를 뒤지고 코드를 검색해서 위치를 찾아줍니다.
3. **Oracle**: 복잡한 아키텍처 설계나 디버깅이 필요할 때, 코드 전체를 깊이 분석하여 조언을 줍니다.
4. **Explore**: `grep`보다 똑똑하게 코드베이스를 탐색하여 관련된 파일들을 수집합니다.

Sisyphus는 이들을 적재적소에 호출하여, 혼자서는 해결할 수 없는 복잡한 문제도 척척 해결합니다.

# 3. 주요 기능: 개발자의 멘탈 모델을 그대로

### 🧠 Artifact Management (기억 관리)
개발자가 코드를 짤 때 머릿속에 담아두는 '맥락(Context)'을 Sisyphus는 **Artifact**라는 형태로 관리합니다.
- "아까 수정한 `User.ts` 파일 내용 기억해줘."
- "방금 실행한 테스트 로그 저장해놔."
이 정보들은 세션이 길어져도 잊혀지지 않고 유지됩니다.

### 📍 Checkpoint System (체크포인트)
"아, 방금 수정한 거 취소하고 다시 할래."
Sisyphus는 작업을 수행하기 전에 자동으로 파일 시스템의 스냅샷(Checkpoint)을 뜹니다. AI가 코드를 망쳐놔도 언제든 **Undo** 명령어로 안전하게 되돌릴 수 있습니다.

### 🔄 Self-Correction Loop (자가 수정)
코드를 수정하고 나서 `npm test`를 돌렸는데 실패했다면? Sisyphus는 에러 로그를 읽고 **스스로 원인을 분석하여 재수정**합니다. 이 과정을 테스트가 통과할 때까지 반복합니다. (물론 무한 루프를 막기 위한 제한도 있습니다.)

# 4. 왜 Sisyphus를 써야 하는가?

OpenCode만 설치해서 쓰는 것(Vanilla)과 Oh My OpenCode(Sisyphus)를 깔아서 쓰는 것은 **"메모장"과 "IntelliJ"의 차이**와 같습니다.

* **더 똑똑한 문맥 파악**: LSP(Language Server Protocol)를 적극 활용하여 함수 정의를 찾아다닙니다.
* **도구 사용 능력**: 브라우저를 띄워 문서를 검색하거나, 이미지를 보고 UI를 수정하는 멀티모달 능력도 갖추고 있습니다.

# 마치며

OpenCode가 하드웨어라면, Sisyphus는 그 위에서 돌아가는 **운영체제(OS)** 입니다.
단순한 코딩 보조를 넘어, 나만의 'AI 부사수'를 원하신다면 지금 당장 Sisyphus를 설치해보세요!!

```bash
# Sisyphus 설치 (Oh My OpenCode)
bunx oh-my-opencode install
```

이제 무겁고 무거운 바위는 Sisyphus에게 맡기고, 여러분은 창의적인 설계에 집중해보시죠!!!

Sisyphus(시지푸스): OpenCode를 진정한 코딩 파트너로 만드는 두뇌

> 2025년 하반기, 개발자 커뮤니티를 가장 뜨겁게 달군 프로젝트가 있습니다. 출시 직후 폭발적인 반응을 얻으며 **GitHub Star 70K**를 돌파한 오픈소스 AI 코딩 에이전트, **OpenCode**입니다. "Cursor의 오픈소스 대항마", "터미널 기반의 혁명"이라는 수식어가 붙는 이 도구가 왜 이렇게 인기인지, 그리고 우리가 왜 주목해야 하는지 알아봅니다.


# 1. OpenCode란 무엇인가?

**OpenCode**는 터미널(CLI)에서 실행되는 **AI 코딩 에이전트**입니다. 단순히 코드를 추천해주는 Copilot과는 다릅니다. 개발자의 지시를 받고 **직접 파일을 수정하고, 터미널 명령어를 실행하고, 에러를 고칩니다.**

* **완전한 오픈소스**: 코드가 투명하게 공개되어 있으며, 무료로 사용 가능합니다. (물론 LLM API 비용은 별도)
* **로컬 우선 (Local-First)**: 모든 컨텍스트 분석이 로컬 머신에서 이루어집니다. 프라이버시를 중시하는 기업 환경에서도 안전하게 사용할 수 있습니다.

# 2. 왜 7만 명의 개발자가 열광했는가?

### 🚀 터미널 중심의 워크플로우 (TUI)
많은 AI 도구들이 IDE(VS Code 등)에 기생하는 플러그인 형태인 반면, OpenCode는 **터미널 그 자체**가 됩니다. Vim/Neovim 사용자나 CLI를 선호하는 서버 개발자들에게 열광적인 지지를 받고 있습니다.

### 🧠 놀라운 문맥 이해 (Context Awareness)
단순히 현재 열려있는 파일만 보는 게 아닙니다. 프로젝트 전체 구조, `git diff`, 심지어 **LSP(Language Server Protocol)**와 연동하여 함수 정의나 참조 관계까지 파악합니다. 덕분에 "이 함수 바꿔줘"라고 하면, 그 함수를 호출하는 다른 파일들까지 알아서 찾아 수정합니다.

### 🛠 강력한 도구 사용 능력 (Tool Use)
OpenCode는 단순히 코드를 짜는 것을 넘어, 다음과 같은 도구들을 자유자재로 씁니다.
* **Shell Execution**: 테스트를 돌리고(`npm test`), 실패하면 로그를 읽고 스스로 고칩니다.
* **Browser Control**: (옵션) 웹 브라우저를 띄워 문서를 찾아보거나 로컬호스트를 테스트합니다.
* **File Manipulation**: 파일을 생성, 삭제, 이동, 수정합니다.

# 3. 주요 기능 (Features)

1. **Zen Mode**: 코딩에 최적화된 LLM 모델(Claude 3.5 Sonnet, GPT-4o 등)을 자동으로 벤치마킹하여 골라주는 모드입니다.
2. **Privacy Focus**: 코드를 외부 서버에 저장하지 않습니다. 오직 LLM 추론을 위해서만 데이터를 보냅니다.
3. **Self-Correction**: 코드를 작성한 후 자동으로 린트(Lint)를 돌리거나 컴파일을 시도하고, 에러가 나면 즉시 수정하는 루프를 돕니다.

# 4. 설치 및 사용법

설치는 매우 간단합니다. 터미널 한 줄이면 끝납니다.

```bash
curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | bash
```

설치 후 프로젝트 폴더에서 `opencode`라고 치면, 에이전트와의 대화가 시작됩니다.

```bash
$ opencode
> "현재 프로젝트의 테스트 코드를 전부 실행해보고, 실패하는 부분을 고쳐줘."
```

# 마치며: AI와 페어 프로그래밍하는 시대

OpenCode는 AI가 단순히 '보조 도구'가 아니라 **'동료(Agent)'**가 될 수 있음을 증명하고 있습니다. 특히 오픈소스 생태계의 힘을 빌려 상용 도구(Cursor, Windsurf) 못지않은 퀄리티를 보여준다는 점이 고무적입니다.

아직 사용해보지 않으셨다면, 오늘 퇴근 전에 터미널을 열고 OpenCode를 설치해 보세요. 여러분의 생산성이 10배는 뛸지도 모릅니다. 🚀

OpenCode

이 주제의 기록

Sisyphus(시지푸스): OpenCode를 진정한 코딩 파트너로 만드는 두뇌

[화제] OpenCode: GitHub Star 7만 개를 돌파한 오픈소스 AI 에이전트의 정체