Skip to main content
Glama
deenesjakoruzh
dr-code

tessera

by dr-code
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Tessera

Claude Code를 위한 지속적인 코드베이스 메모리 — 오픈 소스, 라이선스 제한 없음.

Tessera는 Claude Code에 프로젝트에 대한 의미론적 이해를 제공하며, 이는 턴과 세션을 넘어 지속되어 중복 파일 재읽기를 제거하고 구조화된 작업 기록을 제공합니다.

작동 방식

  1. tessera scan . — 코드베이스의 SQLite 그래프를 구축합니다 (파일, 심볼, 임포트)

  2. Claude가 매 턴마다 graph_continue를 호출 — 캐시되고 점수가 매겨진 파일 추천으로 라우팅

  3. graph_register_edit가 편집 후 그래프를 업데이트하고, 계획 체크리스트를 자동 확인

  4. 선택 사항: tessera debate "task"를 실행하여 Claude와 GPT 간의 다중 라운드 계획 토론

Related MCP server: RLM Memory MCP Server

설치

Claude Code 플러그인 (권장)

claude plugin marketplace add dr-code/tessera
claude plugin install tessera@tessera

이것은 MCP 서버를 등록하고 (uvx를 통해 — Python 환경 불필요) 모든 스킬을 자동 설치합니다 (/build, /debate, /cleanup, /plan-review, /codex-review). 그런 다음 모든 프로젝트에서:

tessera scan .          # builds graph, writes .mcp.json and CLAUDE.md

pip (수동 / CI)

curl -fsSL https://raw.githubusercontent.com/dr-code/tessera/main/install.sh | bash

claude CLI가 있으면 스크립트는 플러그인 마켓플레이스를 사용합니다 (uvx를 통해 MCP 서버를 등록하고 모든 스킬을 설치). 없으면 pip install tessera로 대체하고 스킬을 ~/.claude/skills/로 복사하도록 제안합니다.

그런 다음 모든 프로젝트에서:

tessera scan .          # builds graph, writes .mcp.json and CLAUDE.md

수동 대안

# Claude Code plugin (two steps)
claude plugin marketplace add dr-code/tessera
claude plugin install tessera@tessera

# pip only
pip install tessera          # core — no API keys needed
pip install tessera[debate]  # adds debate mode (requires ANTHROPIC_API_KEY + codex CLI)
pip install tessera[dashboard]
pip install tessera[all]

빠른 시작

cd my-project
tessera scan .          # builds graph, writes .mcp.json and CLAUDE.md
tessera status          # show graph stats
tessera dashboard       # start dashboard at localhost:5050

MCP 등록

tessera scan . 후, 프로젝트에 .mcp.json이 생성됩니다:

{
  "mcpServers": {
    "tessera": {
      "command": "uvx",
      "args": ["--from", "tessera", "tessera", "mcp"],
      "env": { "TESSERA_PROJECT_ROOT": "/path/to/project" }
    }
  }
}

uvx는 첫 실행 시 PyPI에서 tessera를 가져와 캐시합니다 — PATH 항목이 필요 없습니다. Claude Code가 자동으로 인식합니다.

CLI 참조

tessera scan [PATH]              Build/rebuild the graph
tessera mcp                      Start MCP server (stdio)
tessera status [PATH]            Show graph stats
tessera decisions [PATH]         List locked decisions
tessera reset [PATH]             Clear action graph
tessera plans [PROJECT [SUB]]    List archived plans
tessera verify [PATH]            Compliance: plan vs git diff
tessera handoff [PATH]           Generate clipboard handoff summary
tessera debate "task" [flags]    Run Claude vs GPT debate
tessera dashboard [PATH]         Start dashboard at localhost:5050

토론 모드

pip install tessera[debate]와 codex CLI가 필요합니다.

ChatGPT에 연결 (API 키 불필요)

ChatGPT Plus 또는 Pro 구독이 있으면 codex CLI를 인증할 수 있습니다 — 별도의 API 키나 결제 설정이 필요하지 않습니다:

npm install -g @openai/codex   # install once
codex auth login               # opens browser — sign in with your ChatGPT account

그게 전부입니다. tessera debate와 모든 Claude Code 스킬 (/debate, /build, /cleanup 등)이 자동으로 구독을 사용합니다.

API 키를 통한 연결 (선택 사항)

구독 OAuth 경로 대신 직접 API 결제를 선호하는 경우 OPENAI_API_KEY를 설정하세요.

tessera debate "Add JWT authentication" \
  --project myapp \
  --subtask auth-middleware \
  --max-rounds 3

기능 플래그

플래그

기본값

효과

TESSERA_ENABLE_DEBATE

on

tessera debate 활성화

TESSERA_ENABLE_DASHBOARD

on

tessera dashboard 활성화

TESSERA_ENABLE_COMPLIANCE

on

tessera verify 활성화

대시보드는 기본적으로 127.0.0.1에 바인딩되며 인증이 없습니다. LAN 액세스를 위해 TESSERA_DASHBOARD_HOST=0.0.0.0을 설정하면 모든 /api/* 경로(프로젝트 그래프, 계획, 잠긴 결정)가 네트워크상의 누구에게나 로그인 없이 접근 가능해집니다 — 신뢰할 수 있는 네트워크에서만 이렇게 하세요.

토큰 절감 목표

지표

목표

턴 2+ 읽기 감소

콜드 스타트 대비 문자 50% 이상

10턴 세션 감소

전체 문자 40% 이상

캐시 적중률 (턴 3 이후)

60% 이상

심볼 발췌 절감

전체 파일 읽기 대비 70% 이상

Claude Code 세션 내 스킬

Tessera는 컨텍스트를 위해 tessera 그래프를 사용하고 GPT의 관점을 위해 Codex CLI를 사용하는 5개의 Claude Code 슬래시 명령어를 제공합니다. 플러그인 마켓플레이스 설치 시 이 저장소의 skills/ 디렉토리에서 자동 설치됩니다. 수동 설치는 ./install.sh를 실행하거나 skills/에서 ~/.claude/skills/로 복사하세요.

필요 사항: codex CLI (npm install -g @openai/codex)가 codex auth login (ChatGPT 구독) 또는 OPENAI_API_KEY로 인증되어야 합니다.

스킬

사용법

설명

/debate

/debate "REST vs GraphQL"

아키텍처 또는 설계 결정에 대한 다중 라운드 Claude vs GPT 토론

/build

/build "add JWT auth"

전체 빌드 루프: GPT 계획 → 토론 → 사용자 승인 → 구현 → GPT 검토

/cleanup

/cleanup src/

양방향 슬롭 스캐너 — Claude + GPT가 독립적으로 분석한 후 조정

/plan-review

/plan-review plan.md

코딩 전 구조적 검토를 위해 구현 계획을 GPT에 전송

/codex-review

/codex-review HEAD~2

스테이징된 변경 사항, 커밋 또는 파일에 대한 독립적인 GPT 코드 검토

모든 스킬은 tessera MCP가 구성되지 않았을 때도 정상적으로 작동합니다 — 그래프 컨텍스트 없이도 Claude+GPT 협업을 실행합니다.

라이선스

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers