meitarbe/cognetivy

웹사이트: cognetivy.com

에이전트를 위한 추론 오케스트레이션 (Reasoning orchestration): 내구성이 있는 워크플로우 (workflows), 실행 (runs), 이벤트 (events), 그리고 컬렉션 (collections) — 로컬 스튜디오 (local studio) (브라우저 UI + 실행기)와 로그인 시 제공되는 클라우드 (cloud) 동기화를 지원합니다.

AI 코딩 에이전트는 결과물을 생성하는 데는 뛰어나지만, 그 과정은 대개 검사하기 어렵고 반복하기 힘듭니다.

Cognetivy는 에이전트에 운영 계층 (operational layer)을 부여하여 다음과 같은 작업을 가능하게 합니다:

명시적인 워크플로우 (workflows)로 작동 방식 정의
각 실행 (run) 및 이벤트 (event)에서 발생한 일 추적
구조화된 컬렉션 (collections)에 추론 아티팩트 (reasoning artifacts)를 체계적으로 보관
지속적인 로컬 워크스페이스 (local workspace)를 통한 결과 재실행 및 비교

요약하자면: Cognetivy는 강력하지만 혼란스러운 에이전트 세션을 구조화되고 감사 가능한 (auditable) 워크플로우로 변환합니다.

당신의 코딩 에이전트를 매우 똑똑한 인턴이라고 생각해보세요:

**모델 (model)**은 두뇌이고
**에디터 (editor)**는 작업 공간이며
Cognetivy는 메모리 + 프로세스 관리자입니다.

Cognetivy가 없다면, 많은 중요한 컨텍스트 (context)가 채팅 기록에 머물다 사라집니다. Cognetivy를 사용하면 해당 작업이 워크플로우, 실행, 이벤트, 컬렉션으로 캡처됩니다.

• 반복 가능한 로컬 AI 코딩 워크플로우 구축
• 코딩 에이전트를 활용한 구조화된 연구 작업 수행
• 로컬 에이전트 출력물에 대한 추적 가능성 (traceability)과 감사 가능성 (auditability)이 필요한 팀

온보딩 (Onboarding). CLI를 설치한 다음, 프로젝트 폴더에서 cognetivy를 실행하세요.

아직 로그인하지 않은 경우, CLI가 앱(또는 로컬 스튜디오)을 열어 한 번의 승인을 거칠 수 있게 합니다. API 키는 사용자의 기기에 저장됩니다. 최소한의 워크스페이스가 .cognetivy/ 아래에 나타나며,

상태(state)가 리포지토리 (repo) 바로 옆에 유지됩니다.

로컬 스튜디오 (Local studio, 기본값). 서브커맨드 없이 Cognetivy를 실행하면 로컬 스튜디오가 시작됩니다. 이는 소규모 서버 (HTTP + WebSocket), 브라우저에 포함된 UI, 그리고 사용자의 기기에서 실행 (runs)과 노드 (nodes)를 진행시키는 **실행기 (executor)**로 구성됩니다. 워크플로우를 시각적으로 설계하고 검사하며, 실행 내용을 확인하고, 채팅만으로는 흐름을 놓치기 쉬운 실행 과정을 직접 제어할 수 있습니다.

워크플로우 생성 및 발전. **템플릿 (template)**을 선택하여 클라우드 워크플로우에 **적용 (apply)**하거나, 스튜디오에서 그래프를 구성할 수 있습니다. 내장된 템플릿(workflow templates)을 찾아보고, 하나를 구체화하여 버전별로 반복 작업(iterate)할 수 있습니다. cognetivy auth login을 사용하거나 COGNETIVY_API_KEY를 설정하면 CLI와 UI가 동일한 워크플로우 인덱스 및 클라우드 워크플로우와 동기화된 상태를 유지합니다.

Node.js ≥ 18 버전이 의존성으로 포함되어 있습니다 (다른 프로젝트와 마찬가지로 네이티브 빌드 / 프리빌드(prebuilds)가 적용됩니다). better-sqlite3가 포함됩니다.

다음 명령어를 한 번만 실행하면 됩니다:

npx cognetivy

또는 모든 디렉토리에서 사용할 수 있도록 전역(globally)으로 설치하세요:

npm install -g cognetivy
cognetivy

명령어	목적
cognetivy	로컬 스튜디오 시작 (필요 시 첫 대화형 사용 시 안내된 로그인 진행).
cognetivy auth login / auth status	클라우드 API 키 및 확인된 URL.
cognetivy docs	브라우저에서 CLI 문서 열기.
cognetivy workflow …	목록 조회, 생성, 가져오기, 템플릿, 템플릿 적용, 현재 워크플로우 설정 등 …
cognetivy run …	실행 시작 및 진행, 상태, 단계(step).

전체 트리 구조를 확인하려면 **cognetivy --help**를 사용하세요.

이 패키지는 TypeScript/JavaScript API를 제공합니다 (package.json의 main 참조): 워크스페이스 헬퍼(workspace helpers), 모델(models), 설정(config), 검증(validation) 및 관련 유틸리티가 포함됩니다. CLI 바이너리는 cognetivy입니다.

import { /* workspace, models, … */ } from "cognetivy";

저장소의 @cognetivy/core 패키지는 빌드되어 릴리스를 위해 이 패키지로 동기화됩니다. npm 사용자는 일반적으로 이 패키지만 설치합니다.

cognetivy
MIT - 저장소의 LICENSE를 참조하세요.