SuperLogicAI/Logic-Loop

코딩 에이전트가 빠르게 움직입니다. Logic Loop는 당신이 그 속도를 따라잡도록 돕습니다. AI 코딩 프로젝트 전반에 걸쳐 당신의 위치를 유지하세요.

에이전트(Agents)

기능(Features)

설치하기 · 어디서 문제가 발생했는지 알려주세요 · 토론

Logic Loop는 여러 코딩 에이전트 터미널을 한 번에 실행할 수 있는 오픈소스 데스크톱 작업 공간입니다. 당신이 자리를 비운 동안 무엇이 변경되었는지 보여주고, 에이전트들이 당신에게 던진 질문들을 모아주며, 돌아왔을 때 구체적인 다음 행동을 제시합니다.

네 개의 에이전트를 실행하는 것이 어려운 일은 아닙니다. 하지만 그들 사이를 전환하는 것은 어렵습니다. 돌아올 때마다 무엇이 질문되었고, 무엇이 결정되었으며, 다음에 무엇을 해야 했는지 기억하기 위해 스크롤백으로 몇 분을 소모해야 하기 때문입니다. 에이전트 대시보드(Agent dashboards)는 에이전트의 컨텍스트를 추적합니다. Logic Loop는 당신의 컨텍스트를 추적합니다.

홈(Home) → 개요(Overview) → 작업 공간(workspace). 홈은 열었던 모든 프로젝트, 변경된 내용, 그리고 대기 중인 결정 건수를 나열합니다. 프로젝트의 개요는 열려 있는 결정 사항들, 다음 행동, 최근 작업 로그 및 아이디어 보드(Idea Board) 카운트를 보여주며, 복사할 수 있는 상태 업데이트를 구성해 줍니다. '계속하기(Continue)'는 해당 터미널로 당신을 되돌려 놓습니다.

결정 사항(Decisions). 각 에이전트의 턴(turn) 후, 모델은 에이전트가 작성한 내용을 읽고 그 에이전트가 당신에게 던진 질문들, 선택지들, 그리고 명시된 가정들을 추출합니다. 이는 단락 중간에 숨겨진 것까지 포함합니다. 각각은 하나의 카드가 됩니다. '지금 답변하기(Answer now)'는 올바른 탭에 초점을 맞추고 당신의 답장을 미리 채워줍니다. 비활성 상태였던 세션으로부터 14일이 지난 카드는 '오래된(Stale)' 그룹으로 접힙니다.

부재 중인 시간과 다음 행동(Since You Left and Next). 해당 탭이 숨겨져 있는 동안 무슨 일이 일어났는지에 대한 요약본(파일 변경, 실행된 명령어, 오류, 열린 결정 사항; 반복되는 루프 틱은 한 줄로 축소)과 하나의 다음 행동을 제공합니다. 이는 당신의 도착 메모(landing note), 별표 표시된 아이디어 보드 카드, 가장 오래된 열려 있는 결정 사항, 또는 다음에 계획된 카드가 될 수 있습니다.

많은 에이전트를 위한 단일 셸(One shell for many agents). 라이브 상태를 가진 브라우저 스타일의 탭, 북마크, 프로젝트 간 인박스(Cmd/Ctrl+K), 두 개의 패널로 분할하기(two-pane split), 아무것도 일시 중지하지 않고 알림을 무음으로 만드는 잠금 기능(Lock-in), 실패한 명령어로 하단에 표시되는 수동 추적 블로커(Blockers), 그리고 Claude/Codex 사용량 측정기(usage meters)를 제공합니다.

플랫폼 상태. macOS (Apple Silicon)가 일일 빌드 버전입니다. Windows는 실험적입니다: CI에서 Rust 코어를 Windows로 컴파일하고 테스트하지만, 앱 자체는 가볍게 테스트되었으며 **+**와 북마크 기능이 아무것도 하지 않는다는 보고는 아직 재현되지 않았습니다. Linux는 미테스트 상태입니다: CI 빌드도 없고 설치 가이드도 없습니다.

아직 사전 구축된 다운로드는 없습니다. Rust와 Node 22.12 이상을 사용하여 소스에서 빌드하세요:

git clone https://github.com/SuperLogicAI/Logic-Loop.git
cd Logic-Loop
npm ci
...

Windows의 경우, 먼저 Tauri의 필수 구성 요소를 설치하십시오: npm run tauri build -- --bundles nsis는 서명되지 않은 설치 프로그램(SmartScreen에서 경고가 표시됨)을 생성합니다.

에이전트 기능을 사용하려면 최소한 하나의 지원되는 에이전트 CLI를 설치해야 합니다. 아무것도 설치하지 않고 기본 셸 탭으로도 작동합니다.

**설정 (Setup)**은 첫 실행 시 열리며, 어떤 에이전트 CLI가 있는지 감지하고 각 어댑터가 무엇을 지원하는지 알려줍니다.- 클릭하여 **활성화 (Enable)**할 수 있습니다. 이는 Logic Loop의 후크(hook) 또는 플러그인을 해당 에이전트 자체 설정에 기록합니다(어떤 부분을 건드리는지). 클릭하기 전에는 아무것도 설치되지 않습니다. 세션 시작 (Start a session): 프로젝트 폴더와 에이전트를 선택합니다. 어댑터는연결됨 (Connected) 상태가 된 후에만 첫 번째 실제 이벤트를 보낼 때 읽습니다.- 짧은 투어(tour)가 패널들을 안내합니다. 설정과 투어는 헤더에서 다시 열 수 있습니다.

에이전트는 포크(fork)를 만났고 그 포크는 당신에게 도달하지 않습니다. 에이전트가 두 가지 질문을 하면, 당신은 하나에 답하고 나머지 하나는 모델이 가정하는 대로 됩니다. 또는 무언가를 가정할 것이라고 말하며 계속 진행합니다. 터미널에는 완료된 작업이 표시되지만, 당신을 위해 어떤 선택이 이루어졌는지는 아무것도 보여주지 않습니다. 각각은 지금 정착시키기 위한 한 줄이며, 나중에 20번의 턴(turn)이 쌓인 후에 재작업될 것입니다.

자체 보고가 아닌 기록(transcript)에서 읽습니다. 에이전트에게 포크를 플래그 하라고 요청하는 것은 에이전트가 인지한 것만 잡아낼 뿐입니다. Logic Loop는 에이전트가 실제로 작성한 내용을 읽어냅니다.

설계상 보수적입니다. 잘못된 카드는 주의를 낭비하므로, 프롬프트(prompt), 기본 모델(default model), 그리고 골든 테스트 세트(golden test set)는 정밀도(precision)에 중점을 둡니다. 수사학적 질문, 에이전트가 같은 메시지 내에서 스스로 답하는 질문, 그리고 "알려주세요..."와 같은 끝맺음은 건너뜁니다. 에이전트가 말로 표현하지 않은 포크는 잡아낼 수 없습니다.

답변은 하나의 동작입니다. 지금 답변하면 답장이 올바른 탭에 배치됩니다. 해제(Dismiss)는 한 번의 클릭이며, 세션 클러스터가 즉시 정리됩니다.

앱은 절대 대신 답변하지 않습니다. 스스로 실행 중인 세션에 내용을 작성하지 않습니다. 이는 설정이 아닌 아키텍처 규칙입니다.

여섯 가지 모두 활동 및 상태 추적(activity and state tracking), 팬아웃(fan-out), 결정 추출(decision extraction), 세션 재진입(session re-entry) 기능을 지원합니다.

알려진 제한 사항:

• Antigravity는 실패한 명령어의 종료 상태를 제거하므로, 탭에는 오류(error) 대신 *작동(working)*으로 표시됩니다.
• Pi와 DeepSeek은 실패 신호를 노출하지 않으므로, 감지된 차단기(blockers)를 추가하지 않습니다.
• DeepSeek 재진입은 모델 컨텍스트는 복원하지만, 이전 채팅 내용을 터미널에 다시 재생하지는 않습니다.

Logic Loop는 의미를 위해 터미널 화면을 읽지 않습니다. 이벤트는 각 에이전트의 후크(hooks), 기록 또는 플러그인 API에서 옵니다. 터미널 바이트는 건드리지 않고 통과합니다. 패널은 로컬 SQLite에 있는 추가 전용 이벤트 로그(append-only event log)를 기반으로 한 단순 SQL 뷰입니다. 데이터 수집(ingestion)이나 추출이 중단되어도, 사용자의 터미널은 계속 작동합니다.

세 가지 기능은 Setup의 Sidebar LM 카드에서 선택한 백엔드를 사용하여 모델을 호출합니다: Claude CLI (기본값), Codex CLI, LM Studio 또는 Ollama.

| 모델 | 추출당 비용 | 1,000회 호출당 | 중앙값 시간 |
|---|---|---|
| Haiku 5.5 (기본값) | $0.0002–$0.0007 | $0.19–$0.69 | 3.2 s |
| Sonnet 5.5 | $0.0026–$0.0072 | $2.60–$7.20 | 3.7 s |

측정 기준은 API 리스트 가격으로 2026-10-08에 14개 케이스 골든 세트를 사용했습니다. 낮은 비용은 프롬프트 캐시 적중(prompt-cache hit)을 의미합니다. npm run golden이 수치를 다시 출력합니다. 랜딩 노트와 커밋 메시지는 전송되는 턴 또는 diff에 따라 규모가 조정됩니다. Claude의 객관식 프롬프트는 모델 호출 없이도 후크에서 바로 Decision 카드로 변환됩니다. Claude 또는 Codex CLI에서 이러한 호출은 사용자의 자체 플랜 한도를 소모합니다. LM Studio 또는 Ollama에서는 기기 내에서 처리됩니다.

Agent config: 오직 활성화(Enable)를 클릭했을 때만 적용되는, 에이전트별로 나열된 파일입니다. 비활성화하면 Logic Loop의 항목이 바이트 단위로 제거되며, 사용자의 자체 후크는 유지됩니다.Claude, 탭 전용 모드(Setup → Claude →Logic Loop tabs only): 후크와 상태 표시줄 래퍼가 ~/.context-terminal/claude-settings.json에 저장되는 대신, Logic Loop의 zsh 탭에서 --settings로 claude에 전달됩니다. 사용자의 ~/.claude/settings.json은 절대 작성되지 않으므로, git에 보관하거나 기기 간 동기화하는 설정 파일에 적합합니다. 트레이드오프: Logic Loop 탭 외부(다른 터미널, IDE, bash/fish 탭)에서 실행되는 Claude는 감지되지 않습니다.Claude 상태 표시줄, 옵트인한 경우에만 적용됩니다: 기존의 statusLine.command를 감싸줍니다.

사용법을 확인하려면. 줄은 여전히 표시되며, 이를 끄면 원래 상태로 돌아갑니다.: 데이터베이스, 설정 및 앱 소유의 zsh 시작 파일을 사용합니다. zsh 탭만 Logic Loop가 사용하며, 자체 dotfiles를 로드한 다음 ~/.context-terminal/에 추가합니다.

--no-daemon

codex

을 사용하여 각 탭이 자신의 세션을 보고하도록 하고, 탭 전용 모드에서는 --settings

claude

를 추가합니다. 사용자의 dotfiles는 절대 수정되지 않습니다. 프로젝트 내부에서는 Idea Board와 커밋할 수 있는 일반 마크다운 파일(.logic-loop/board.md)이 있습니다.

로컬호스트: 후크가 베어러 토큰으로 보호되는 로컬 인제스트 서버에 게시됩니다.

제거하려면, 먼저 설정에서 각 어댑터를 비활성화한 다음 앱과 ~/.context-terminal/를 삭제하십시오.

만약 에이전트가 같은 팀의 로컬 우선 모델 라우터인 Safe Router를 통해 경로 지정된다면, Traffic 뷰는 최근 경로 지정된 요청과 실제로 어떤 모델이 각 요청을 처리했는지 목록으로 보여줍니다. 이는 Safe Router의 로그를 읽기 전용으로 열며, 로그가 발견되면 제어판이 나타납니다.

버그 보고, 어댑터 요청 및 PR 환영합니다. npm run tauri dev로 앱을 개발 모드에서 실행하십시오. CONTRIBUTING.md는 병합 게이트와 아키텍처 규칙을 다루며; AGENTS.md는 이 저장소에서 작업하는 에이전트들을 위한 공유 가이드입니다. 방향은 docs/ROADMAP.md를 참고하십시오.

Super Logic AI가 구축했습니다 — 소규모 비즈니스를 위한 AI 자동화.