conectlens/lenserfight

AI 프롬프트를 재사용 가능하고, 체계적이며, 실행 가능하고, 측정 가능한 자산으로 변환하세요.

• 문제점
• LenserFight란 무엇인가
• 데모
• 안정적인 기능
• 사용 사례
• 현재 개발 상태
• CLI 빠른 시작
• 빠른 시작 (웹 앱)
• Connect LF Cloud MCP를 Claude, Codex 및 기타 AI 어시스턴트와 연결하기
• 리포지토리 개요
• 문서화
• 기여
• 후원 및 지원
• 보안, 지원 및 라이선스

AI 프롬프트, 대화, 모델 설정, 워크플로우, 평가 결과는 보통 채팅 기록, 메모 앱, 일회성 스크립트에 흩어져 있습니다. 이들은 버전 관리가 어렵고, 작성된 후 발견하기 어려우며, 작업이나 팀 전반에 걸쳐 재사용하기 어려울 뿐만 아니라, 서로 일관되게 측정되는 경우가 거의 없습니다.

LenserFight는 AI 지침을 일회성 채팅 메시지가 아닌 구조화되고 재사용 가능한 자산으로 변환하는 오픈 소스 프롬프트 관리 및 AI 워크플로우 자동화 플랫폼입니다. 이 플랫폼은 전체 수명 주기를 다룹니다:

Lens로 프롬프트를 생성: 명시적인 계약을 가진 버전 관리되고 매개변수화된 지침(one-off message가 아님)인 Lens를 만드세요.
태그(검색)와 스레드(반복 및 피드백)를 통해 Lens를 정리하고 논의: Lens를 정리하고 토론하세요.
Lenser— Lens를 생성하고 실행하는 사람과 AI 에이전트 — 를 통해 정체성을 구축하고, 기여 기록을 추적하는 XP를 활용하세요.
반복 가능한 워크플로우(Workflows)로 자동화: Lens와 도구를 연결하여 워크플로우를 만드세요. 이는 일반적인 앱 통합보다는 AI 지침에 특화된 자동화 플랫폼 구축(n8n, Zapier 스타일의 파이프라인)이라고 생각할 수 있습니다.
에이전트(Agent)로 구성: 워크플로우와 일련의 Lens를 구성하여 필요하거나 스케줄에 따라 실행할 수 있는 에이전트를 만드세요.
구조화된 배틀(Battles)을 통해 평가: 반복 과정을 평가하세요. 이는 오늘날 실험적인 기능이며, 이 README의 초점은 아닙니다.

|
|

pnpm hero:preview를 사용하여 로컬 인스턴스에 대해 자동 생성된 스크린샷입니다. - 스테이징되지 않은 스크린샷.

렌즈 관리(Lens management) (생성, 매개변수, 버전), 스레드(Threads), 태그(Tags), 렌저(Lensers), 그리고 XP는 오늘 안정화되었습니다 — 이 다섯 가지 모두 실제 도메인 로직, 실제 데이터 계층, 작동하는 UI, 테스트 커버리지를 갖추고 있습니다. 자세한 내용은 ROADMAP.md를 참고해 주십시오. 또한 '안정적'이라는 것이 아직 포함하지 못하는 부분(워크플로우(Workflows), 에이전트(Agents), 배틀(Battles) — 아래 참조)에 대해서도 확인하실 수 있습니다.

재사용 가능한 렌즈 라이브러리를 유지하세요: 매번 기억 속에서 같은 프롬프트를 다시 작성하는 대신, 버전 관리되고, 매개변수화되며, 검색 가능한 방식으로 관리할 수 있습니다.반복되는 AI 작업을 워크플로우로 자동화하세요: 렌즈(Lenses), 도구(tools), 그리고 조건부 단계를 하나의 파이프라인으로 연결하여, 마치 n8n이나 Zapier에서 자동화를 구성하듯이 사용할 수 있지만, 앱 간의 트리거 대신 AI 명령어와 모델 호출을 기반으로 합니다.신뢰하는 렌즈 세트를 워크플로우에 결합하여 도구 사용 에이전트를 프로토타입하세요: 그리고 스케줄 또는 MCP 연결을 할당해 주면 됩니다.스레드를 통해 렌즈를 논의하고 개선하세요: 채팅 기록에서 프롬프트 변경의 근거를 잃어버리는 대신, 이를 통해 의견을 나누고 발전시킬 수 있습니다.태그를 통해 기능을 발견하세요:

브라우저를 열 필요 없이 모든 Lens, Workflow, Agent 및 Lenser 작업을 수행할 수 있습니다. 한 번 설치하고 로그인한 후 바로 사용하세요:

npm install -g @lenserfight/cli
lf --version

설치할 필요가 없습니다. 먼저 시도해 보세요:

npx @lenserfight/cli --help

그다음 온보딩을 진행하세요:

lf init # .lenserfight.json 생성 (기본값은 클라우드 모드)
lf auth login # 브라우저 기반 로그인
lf onboard # 안내되는 첫 실행: 인증 확인 → 프로필 → 첫 템플릿

계정이나 클라우드가 필요하지 않습니다. 로컬 Ollama 모델을 대상으로 CLI를 완전히 오프라인으로 테스트해 보세요:

lf run exec --ollama --model llama3.2 --prompt "MIT 라이선스를 한 문장으로 요약하세요"

lf 실행하기

인수 없이 lf를 실행하면 내장 터미널 대시보드가 열립니다. 사이드바 탐색을 통해 Agent, Workflow, Schedule, Memory 등 모든 항목에 접근할 수 있으며, 이는 모든 스크립트 명령과 동일한 라우팅 및 안전 장치를 가집니다.

전체 명령어 참조, 설정 및 환경 변수:
apps/cli/README.md

· CLI 문서 ·
CLI: 시작하기 튜토리얼

권장 사항: 로컬 모드를 사용할 계획이라면 Docker를 설치하세요. 클라우드 모드(CLI 기본값)와 파일 워크스페이스 명령어(lf battle file, lf validate, lf workflow run)는 Docker가 전혀 필요하지 않습니다. Docker는 오직 lf use local / lf --local 및 lf dev에만 필요하며, 이 명령들은 로컬 Supabase 스택을 구동합니다:

macOS / Windows: Docker Desktop 설치 후, docker --version으로 확인하세요.Linux: Docker Engine 설치 후, sudo usermod -aG docker $USER를 실행하세요 (적용하려면 로그아웃/로그인).

권장 사항: 먼저 Docker를 설치하세요. 로컬 Supabase 스택(Postgres, Auth, Storage, Realtime)은 Docker 컨테이너에서 실행됩니다. 이 빠른 시작 가이드에서는 다른 것이 필요하지 않지만, 이것 없이는 pnpm supabase start 단계에서 막히게 됩니다.

macOS / Windows: Docker Desktop을 설치하고 실행 여부를 확인하세요: docker --version.

.Linux: 배포판에 맞는 Docker Engine을 설치한 후, 사용자를 docker 그룹에 추가하여 모든 명령어에 sudo가 필요하지 않게 하세요: sudo usermod -aG docker $USER (적용하려면 로그아웃/로그인).

전체 제품(웹 앱, 인증 기능, 로컬 Supabase 스택 포함)을 하나의 명령어로 실행합니다:

git clone https://github.com/conectlens/lenserfight.git
cd lenserfight
./scripts/dev-start.sh # 로컬 Supabase + Vite 부팅

그런 다음 http://localhost:3000을 엽니다.

. 전체 로컬 설정 가이드 → ·
문제 해결 →

또는 각 부분을 직접 실행합니다:

pnpm install --frozen-lockfile
pnpm supabase start
pnpm supabase:db:reset
...

Node 22(.nvmrc 참조)와 Docker(로컬 Supabase용)가 필요합니다. 풀 리퀘스트는 development 브랜치를 대상으로 합니다 — CONTRIBUTING.md를 참조하세요.

다른 진입점들에는 각각 README가 있습니다: 위의 lf CLI, Claude, Cursor, Codex 또는 다른 MCP 지원 어시스턴트에서 LenserFight를 구동하기 위한 MCP 서버(아래), 그리고 로컬 실행 증명(attestation)을 위한 Trust Gateway(활성화하기 전에 게이트웨이 문서를 참조하세요).

LenserFight는 호스팅된 Model Context Protocol 서버인 LF Cloud를 제공합니다 — 이 서버는 Claude, Codex, Cursor 또는 모든 MCP 지원 어시스턴트가 ID를 탭 간에 복사/붙여넣기 할 필요 없이 Lenses, Workflows, Agents를 직접 생성하고 실행할 수 있게 해줍니다. 이는 하나의 안정적인 엔드포인트에서 55개의 타입화된 도구(Lens, Thread, Workflow, Agent 및 Battle 그룹)를 노출합니다:

• claude.ai → 설정 → 커넥터 → 사용자 지정 커넥터 추가로 이동합니다. - 원격 MCP 서버 URL을 https://mcp.lenserfight.com/mcp로 설정합니다.
  . - OAuth 클라이언트 ID와 클라이언트 시크릿은 비워둡니다 — 서버가 사용자의 클라이언트를 등록하고 PKCE를 자동으로 처리합니다. - 추가를 클릭한 다음 팝업에서 LenserFight 계정으로 로그인합니다. - 새 채팅을 시작하고 다음과 같이 시도해 보세요:
  "LenserFight를 사용하여 내 렌즈 목록을 나열하세요."

MCP 설정(~/.cursor/mcp.json 또는 작업 공간의 .mcp.json)에 항목을 추가합니다:

{

)", 채팅 기록에서 잃어버리는 대신. **이름으로 Lens 실행하기:** ***"Topic=TypeScript로 Lens 실행하기"*** — 어시스턴트가 `code-reviewer`라는 Lens를 호출합니다.

`lens`는 데이터베이스에서 `[[Parameter]]` 토큰을 해결하고, 어시스턴트가 실행할 수 있는 완성된 프롬프트를 반환합니다. **워크플로우 구축 및 자동화:** 비용과 소요 시간을 측정하기 위해 `summarize_workflow`를 생성, 실행 및 요약합니다. 기존 코딩 세션 내에서 Lenses와 도구를 자동화 파이프라인으로 연결하며, 별도의 대시보드 탭이 필요하지 않습니다. **에이전트 가동 (AI Lenser):** 워크플로우와 일련의 Lenses를 에이전트에 구성하고, 도구를 할당하며, 실행을 관리합니다. 에이전트 도구 그룹은 총 55개 도구 중 12개를 다룹니다. **스레드에서 변경 사항 논의:** Lens에 반복 노트와 피드백을 첨부하여 채팅 로그에서 프롬프트 변경의 추론 과정을 잃어버리는 것을 방지합니다.

모든 도구 호출은 Supabase RLS가 적용된 사용자의 인증된 신원 하에 실행됩니다. 어떠한 작업도 사용자 대신 권한이 상향 조정되어 실행되지 않습니다. 파괴적인 작업(`delete_lens`, `archive_ai_lenser`, 배틀 종료/보관)을 수행하려면 명시적으로 `confirm: true`가 필요합니다.

전체 참고 자료 — 55개 도구, 매개변수 테이블, OAuth 세부 정보, 이 저장소 내에서 개발 및 문제 해결을 위한 로컬 `stdio` 모드: MCP Server Reference · Provider Quickstart · `apps/mcp-server/README.md`

.
├─ apps/
│ ├─ web/ 웹 앱 — Lenses, Threads, Tags, Lensers, Workflows, Agents, Battles
...

가져오기 방향: `apps` → `features` → `data` → `domain`; `features` → `ui`; 절대 역순으로 하지 마세요.

- 시작하기 (Getting started)
- 설치 (Installation)
- CLI 참고 자료 — 전체 `lf` 명령어 문서 - CLI: Getting Started
- MCP Server Reference — LF Cloud, 도구, 인증
- 기여자 가이드
- 아키텍처 맵
- 루트 디렉토리 감사
- 워크플로우 실행 엔진
- 커뮤니티 에디션 대 클라우드
- 전체 문서: docs.lenserfight.com

기여(CONTRIBUTING).md부터 시작하세요. 언어를 추가하기 위한 i18n 플레이북을 포함한 기여자 가이드가 docs/en/how-to/contributors/에 있습니다. 더 큰 변경 사항의 경우, 구현에 착수하기 전에 이슈를 여세요.

LenserFight는 오픈 소스로 구축되고 유지됩니다. 이 프로젝트가 귀하 또는 귀하의 팀에게 유용하다면, 스폰서십을 통해 개발을 지속할 수 있습니다:

- GitHub Sponsors
- Patreon
- 스폰서십, 파트너십 또는 기여 관련 질문: **[email protected]**

- 보안 정책(Security policy) — 취약점을 비공개로 신고하는 방법.
- 지원(Support) — 질문을 하거나 버그를 보고할 곳.
- 행동 강령(Code of Conduct) — 프로젝트 공간에서 기대되는 행동.
- 면책 조항(Disclaimer) — 베타, AI 출력 및 배포 제한 사항.
- 소스 코드에 대한 MIT 라이선스. LenserFight 이름과 로고는 MIT 보증의 대상이 아닌 상표입니다.

LenserFight는 베타 버전이며 자체 호스팅 우선 소프트웨어입니다. 운영 데이터나 신뢰할 수 없는 입력에 대해 실행하기 전에 DISCLAIMER.md와 SECURITY.md를 읽어보세요.