에페메럴 샌드박스에서 코드를 작성하고 실행하며, API를 병렬로 쿼리하므로 하나의 질문이 전체 스택에 퍼져 나갑니다. 모든 발견 사항은 교차 검증되어 원래 출처까지 추적됩니다.

코딩 에이전트 및 MCP 서버와 달리, 이 도구는 **구조적으로 읽기 전용**입니다. 모든 호출은 자격 증명이 연결되기 *전에* 게이트를 통과하고 승인됩니다. 프로덕션 환경에 안심하고 연결하세요.
<!-- END agent-about -->

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/9087/1b3db179a03479f5951d624c8adbb4890465aa86d038d3312dc9aec9801bcfb9.gif"
       alt="cynative가 CI에서 클라우드 권한 상승까지 감사하는 모습"
       width="900">
</p>

## 에이전트가 얻는 것

- **코드-투-런타임**: AWS, GCP, Azure, 모든 K8s, GitHub 및 GitLab을 추론합니다
- **샌드박스**: 자체 네트워크나 호스트 액세스 없이 대규모 연구를 위해 코드를 생성하고 실행합니다
- **액션 게이트**: 모든 호출을 필요한 IAM 액션으로 해석하고, 자격 증명이 연결되기 전에 읽기 전용 정책을 적용합니다
- **증거 기반**: 교차 검증을 통해 모든 발견 사항을 확인합니다
- **독립적**: 단일 바이너리, 사용자 모델, 데이터는 사용자 소유로 유지됩니다

## 빠른 시작

LLM을 설치하고 설정합니다:

<!-- BEGIN quickstart-example -->```bash
brew install cynative/tap/cynative

export CYNATIVE_LLM_PROVIDER=anthropic
export CYNATIVE_LLM_MODEL=claude-opus-5
export ANTHROPIC_API_KEY=...

## 첫 번째 에이전트

에이전트는 마크다운 파일입니다. 한 줄의 설명과 그다음에 프롬프트가 옵니다. 파일 이름이 에이전트 이름입니다. 직접 추가하려면 `~/.cynative/agents/`를 만들고 그 안에 하나 작성하세요. Cynative는 이 디렉터리를 자동으로 생성하지 않습니다:```bash
mkdir -p ~/.cynative/agents

cat > ~/.cynative/agents/aws-public-data-stores.md <<'EOF'
---
description: Finds publicly accessible data stores in an AWS account.
---
Check S3, RDS snapshots, EBS snapshots and public AMIs for exposure.
Report each finding with the resource ARN and how it is reachable.
EOF

cynative -p --agent aws-public-data-stores

`--agent`는 `-p`, `--auto-approve`, `--config` 및 파이프된 stdin과 함께 사용되므로, 개발 중에는 동일한 파일이 대화형으로 실행되고 안정화된 후에는 비대화형으로 실행됩니다.

에이전트는 `~/.cynative/agents/`와 바이너리에 내장된 세트에서 읽어옵니다. 사용자 파일은 동일한 이름의 내장 파일보다 우선합니다. `cynative agents list`는 각 에이전트를 소스와 함께 표시하고 가려진 복사본을 표시하며, `cynative agents show <name>`은 실제로 실행될 정확한 파일을 출력합니다.

## MCP를 갖춘 코딩 에이전트로는 안 되나요?

| | 코딩 에이전트 + MCP | Cynative |
|---|---|---|
| 처리량 | 호출당 하나의 작업 | 호출을 동시에 분산하는 샌드박스 코드를 작성 - 더 적은 토큰, 더 빠른 답변 |
| 결과 | 검증되지 않은 출력 | 검증기가 모든 결과를 실시간 증거와 대조 검증 |
| 읽기 전용 | 선택적 읽기 필터 | 기본적으로 켜짐, 실패 시 차단 - 필수 IAM 작업이 보안 감사 정책에 대해 확인됨. `secretsmanager:GetSecretValue`는 IAM *읽기* 작업입니다. 필터는 이를 허용하지만 `SecurityAudit`는 차단합니다 |
| 자격 증명 | 주변 환경, 변경 없음 | 읽기 전용으로 범위가 지정된 STS 세션 - AWS도 경계를 강제합니다 |
| 폭발 반경 | 사용자의 셸, 모든 네트워크 | 연구 코드는 호스트 접근이 없는 샌드박스에서 실행되며, 네트워크는 매핑된 서비스로 고정됨 |
| 비밀 | 모델에 그대로 전송 | 모델로 전송되기 전에 도구 출력에서 삭제됨 |
| 공급망 | 자격 증명으로 실행되는 타사 MCP 및 스킬 | 하나의 오픈소스 바이너리, 커넥터 내장 |
| 감사 추적 | 분산된 세션 로그, 최선 노력 | 모든 도구 호출에 대한 실패 시 차단 JSONL 로그 - 기록할 수 없으면 중단됨 |

하나의 바이너리, 사용자의 모델 엔드포인트, 사용자의 계정. 감사 대상 클라우드의 인스턴스에서 실행하고, 해당 클라우드의 관리형 추론을 통해 실행하면, 어떤 것도 사용자 환경을 벗어나지 않습니다: 사용자 인프라의 보안을 사용자 인프라 내부에서 보호합니다.

## 설치

**Homebrew** (macOS / Linux - 권장):```bash
brew install cynative/tap/cynative

**Windows** (Scoop):```powershell
scoop bucket add cynative https://github.com/cynative/scoop-bucket
scoop install cynative

- **비동기 및 동시 실행**: 도구 함수는 Promise를 반환합니다 - `await`로 기다리거나, `mapConcurrent(items, fn, limit)`로 여러 리소스에 걸쳐 분산 실행(제한적, 순서 보장)하거나, 작은 고정 집합에는 `await Promise.all([...])`을 사용하세요.
- **구조화된 응답**: `http_request`는 `{ status, statusText, headers, body }`로 해석됩니다. `body`는 원시 문자열이며, JSON API에는 `JSON.parse(resp.body)`를, XML에는 직접 읽기를 사용하세요.
- **샌드박스**: 스크립트는 Cynative가 노출하는 도구만 호출할 수 있습니다 - 자체적인 네트워크나 호스트 접근 권한은 없습니다.
- **전체 스크립트 확인**: 각 `code_execution` 호출은 실행 전에 승인을 위해 전체가 표시됩니다(`--auto-approve`로 건너뛰기, `-v`로 각 내부 호출 스트리밍).
- **세션 내 상태 유지**: 대화형 세션 중 호출이 완료될 때까지 실행되는 한 `globalThis`에 저장된 값은 호출 간에 유지됩니다(시간 초과되거나 일시 중단된 호출은 재설정됨). 최상위 `let`/`const`/`var`/`function`은 단일 호출로 범위가 제한됩니다.
- **제한적**: 스크립트는 시간 초과(기본 120초)와 출력 크기 상한 아래에서 실행됩니다.

## 감사 로그

모든 도구 호출은 영구 JSONL 감사 로그(`~/.cynative/audit.log`, 기본 활성화)에 기록됩니다. 로그는 실패 시 폐쇄 방식입니다: 호출을 기록할 수 없으면 실행이 중단됩니다. 에이전트 실행의 모든 항목은 에이전트 이름, 소스 및 파일 다이제스트도 기록하므로, 발견 사항을 생성한 정확한 프롬프트까지 추적할 수 있습니다.

도구 결과는 기록 전에 편집되지만 승인 프롬프트 인수는 그대로 저장됩니다 - 로그에는 민감한 값이 포함될 수 있습니다. Cynative를 실행한 사용자만 읽을 수 있습니다. 순환 및 보존 기간은 구성 가능합니다.

`~/.cynative/config.yaml`의 `audit:` 아래에서 구성하거나 환경 변수를 통해 구성하세요:

| 키 | 환경 변수 | 기본값 |
|---|---|---|
| `audit.enabled` | `CYNATIVE_AUDIT_ENABLED` | `true` |
| `audit.path` | `CYNATIVE_AUDIT_PATH` | `~/.cynative/audit.log` |
| `audit.max_size_mb` | `CYNATIVE_AUDIT_MAX_SIZE_MB` | `100` |
| `audit.retention_days` | `CYNATIVE_AUDIT_RETENTION_DAYS` | `30` |
| `audit.compress` | `CYNATIVE_AUDIT_COMPRESS` | `false` |

## 질문 및 피드백

[Discussions](https://github.com/cynative/cynative/discussions)는 피드백을 공유하기 가장 좋은 곳입니다 - 무엇을 대상으로 했는지, 어떤 결과가 나왔는지, 무엇이 빠졌는지. 별표(Star)는 프로젝트를 사람들이 찾는 데 도움이 됩니다.

## 기여

기여를 환영합니다 - 새로운 에이전트, 커넥터, 평가 데이터셋, 그리고 전반적인 개선 사항. 개발 설정, `make check` 게이트, PR 규칙은 [CONTRIBUTING.md](https://github.com/cynative/cynative/blob/main/CONTRIBUTING.md)를, 취약점 신고는 [SECURITY.md](https://github.com/cynative/cynative/blob/main/SECURITY.md)를 참조하세요.

## 라이선스

Apache-2.0 라이선스. 전체 텍스트는 [LICENSE](https://github.com/cynative/cynative/blob/main/LICENSE)를 참조하세요.