agensic

무엇이, 어디서, 언제, 누가 실행했는지 알 수 있습니다

AI 기반 터미널 워크플로우를 위한 사라진 가시성 계층

Signed Provenance Tracked Sessions Git Time Travel Replayable Sessions IDE style Tab Autocomplete

Agensic은 기존 터미널 워크플로우를 AI 시대에 맞게 업그레이드합니다. 셸에서 AI 에이전트의 생산성 향상을 원하지만 감사 가능성, 제어 및 개인정보 보호를 포기하지 않는 개발자를 위해 설계되었습니다.

AI 에이전트가 점점 더 명령줄을 장악하고 작업을 자율적으로 실행함에 따라 가시성과 제어가 중요해집니다. Agensic은 터미널 명령을 일급 시민으로 취급하여 이를 추적, 검사 및 관리하기 위한 강력한 프레임워크를 제공합니다.

모든 터미널 활동을 하나의 모호한 "셸 기록"으로 평탄화하는 대신, Agensic은 포렌식 관찰자이자 스마트 부조종사 역할을 합니다. 대화형 AI 코딩 세션을 원활하게 추적하고, 에이전트가 실행한 명령에 암호학적 서명을 추가하며, 기록 기반의 IDE 스타일 탭 자동 완성을 제공합니다.

📋 목차

1. 플랫폼 지원
2. 설치
3. 빠른 시작
4. Agensic 출처
   • 기능
   • 지원되는 레이블
5. Agensic 세션
   • 기능
   • 지원되는 에이전트
6. Agensic 자동 완성
   • 기능
   • 지원되는 제공자
7. 사용 가능한 명령어
8. 안전 및 개인정보 보호
9. 프로젝트 제작자
10. 지원
11. 라이선스

💻 플랫폼 지원

Agensic은 셸 환경과 깊이 통합되도록 설계되었습니다.

• macOS (Zsh) — 완전 지원 ✅

• Linux (Bash) — 완전 지원 ✅

🚀 설치

가장 빠른 방법은 관리되는 한 줄 설치 프로그램입니다:

curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash

수동으로 클론하고 싶다면:

git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh

이미 uv가 설치되어 있다면, 설치 프로그램이 자동으로 사용하여 더 빠르게 설정합니다.

첫 실행 시, Agensic은 선호하는 LLM 제공자를 선택하고 명령어 자동 완성을 위한 API 키를 구성하도록 안내합니다.

또는 다음을 실행하여 LLM 제공자와 API 키를 수동으로 구성할 수 있습니다:

agensic setup

⚡ 빠른 시작

설치 후, 새 터미널을 열면 Agensic이 자동으로 터미널 활동 추적을 시작하고 입력할 때 자동 완성 제안을 제공합니다!

🤖 원활한 에이전트 자동 추적

평소처럼 작업을 시작하세요. 예를 들어 Claude Code, Codex CLI 등 좋아하는 AI 코딩 도우미를 사용하면 됩니다:

claude

또는

codex

지원되는 모든 에이전트의 전체 목록은 지원되는 에이전트 섹션을 참조하세요. 목록에 없는 에이전트가 있다면 agensic --add_agent "실행파일"을 실행하여 추가한 후 정상적으로 사용하면 Agensic이 추적합니다.

작업이 끝나면 Agensic을 사용하여 세션 기록을 검사할 수 있습니다:

agensic sessions

또는 포렌식 출처를 확인할 수 있습니다:

agensic provenance

🧾 Agensic 출처

Agensic은 모든 명령에 대한 포렌식 기록을 제공합니다. 발생한 일을 분류하고, 풍부한 메타데이터를 기록하며, 명확한 감사 추적을 제공하여 명령이 수동으로 입력되었는지, 제안을 수락했는지, 또는 에이전트가 직접 실행했는지 알 수 있습니다.

✨ 기능

🔍 전체 화면 출처 탐색기

"여기서 정확히 무엇이 실행되었고 누가 트리거했는가?"에 대한 답이 필요하신가요? agensic provenance를 실행하여 전체 화면 출처 뷰어를 여세요. 레이블, 에이전트, 제공자 또는 시간 창으로 필터링하고, 정확한 명령 추적을 검사하며, 디버깅, 사고 검토 또는 규정 준수를 위해 현재 보기를 JSON 또는 CSV로 내보낼 수 있습니다.

🛡️ 암호화 명령 출처 및 서명

인간인지 AI인지 빌드를 망가뜨렸는지 더 이상 추측하지 마세요. Agensic은 모든 명령에 대한 풍부한 메타데이터를 캡처하고 로컬 Ed25519 서명을 사용하여 에이전트가 실행한 실행에 부인할 수 없는 AI_EXECUTED 레이블을 태그합니다. 인간의 키 입력과 AI 제안 및 자동 실행을 구분하는 명확하고 감사 가능한 타임라인을 얻을 수 있습니다.

🏷️ 구조화된 속성 레이블

Agensic은 터미널 기록을 원시 문자열 목록으로 축소하지 않습니다. 추적된 모든 명령은 출처 레이블로 분류되어 실행을 필터링하고, 동작을 조사하며, 명령이 어떻게 셸에 들어왔는지 이해하는 일관된 방법을 제공합니다.

🔖 지원되는 레이블

Agensic은 현재 다음 출처 레이블을 지원합니다:

• AI_EXECUTED — AI 에이전트가 직접 실행하고 서명된 명령
• HUMAN_TYPED — 인간이 셸에 직접 입력한 명령
• AI_SUGGESTED_HUMAN_RAN — 외부 AI LLM 호출이 제안하고 인간이 실행한 명령
• AG_SUGGESTED_HUMAN_RAN — Agensic이 제안하고 인간이 실행한 명령
• INVALID_PROOF — 검증에 실패한 증명 메타데이터와 함께 도착한 명령
• UNKNOWN — 더 강력한 속성 레이블을 할당하기에 증거가 불충분한 명령

🕵️‍♂️ Agensic 세션

Agensic은 대화형 에이전트 세션을 기록하여, 발생한 일에 대한 부인할 수 없는 증거와 Time Travel 기능을 통해 저장소 상태를 안전하게 조작할 수 있는 기능을 제공합니다.

✨ 기능

▶️ 재생 가능한 세션

어젯밤 세션을 감사하여 무슨 일이 있었는지 이해해야 하나요? agensic sessions를 실행하고 재생할 세션을 선택하세요. 매우 빠른 전체 화면 TUI를 통해 즉시 타임라인을 탐색하고, 페이로드를 검사하며, 세션을 재생할 수 있습니다. 사고 검토를 위해 증거를 공유해야 할 때는 한 번의 키 입력으로 정확한 데이터 세트를 JSON 또는 CSV로 내보낼 수 있습니다.

⏪ Time Travel

"에이전트가 파괴적인 커밋을 만들기 전에 내 저장소가 정확히 어떻게 생겼을까?" 궁금한 적이 있나요? Time Travel을 사용하면 특정 세션 체크포인트에서 캡처된 정확한 Git 상태로 저장소를 되감을 수 있습니다. Agensic은 추적되지 않은 파일과 수정된 파일을 안전하게 새 브랜치로 복원하여 조사 중에 실수로 작업 트리를 망가뜨리지 않도록 보장합니다.

🗄️ 탄력적인 로컬 우선 상태

당신의 데이터는 당신의 것입니다. Agensic은 추가 전용 이벤트 저널과 자동 스냅샷 기능을 갖춘 강력한 SQLite 상태 백엔드를 사용합니다. 따라서 예상치 못한 터미널 충돌, 시스템 재부팅 및 장기간 로컬 사용에도 포렌식 기록이 손상되지 않고 보존됩니다.

🤖 지원되는 에이전트

Agensic은 추적 가능한 사전 구성된 내장 에이전트 세트를 지원합니다:

• Claude Code
• Codex CLI
• Gemini CLI
• OpenClaw
• OpenCode
• Kimi Code
• Mini Agent
• Qwen Code
• GitHub Copilot CLI
• Kiro CLI
• Cline CLI
• Cursor CLI
• Nanoclaw
• Droid
• Hermes Agent
• Ollama
• Mistral Vibe
• Aider
• Pi.dev
• Kilo Code
• Continue CLI

사용자 정의 에이전트: agensic 설정에 실행 파일을 삽입하면 별도 설정 없이 즉시 작동합니다.

⚡ Agensic 자동 완성

Agensic은 터미널 제안을 재상상합니다. 상황 인식, 의미론적이며 항상 빠른 IDE 스타일의 만족스러운 탭 자동 완성입니다.

✨ 기능

🚀 매우 빠른 로컬 기록 제안

입력 지연과 작별하세요. 입력함에 따라 Agensic은 실제 명령 기록 저장소를 쿼리합니다. 제안은 Tab으로 쉽게 수락할 수 있는 고스트 텍스트로 즉시 나타납니다. 패턴을 학습하고 실제 수행하는 작업에 의존하기 때문에 제안은 매우 정확하고 저장소를 인식합니다.

🧠 의미론적 검색 및 오타 복구

인간은 실수를 하지만 Agensic이 고칩니다. dokcer를 입력하면 Agensic이 즉시 Did you mean: docker를 제안합니다. 정확한 구문이 기억나지 않나요? 의미론적 재순위가 의도를 구출하여 접두사가 완벽하게 일치하지 않아도 올바른 명령을 찾습니다: docker records를 입력하면 Did you mean: docker logs를 얻을 수 있습니다 (이전에 docker logs를 실행한 적이 있는 경우).

💡 주문형 AI 폴백

AI는 모든 키 입력에 세금을 부과하는 것이 아니라 강력한 폴백입니다. Agensic은 프롬프트 스팸을 방지하기 위해 줄별 LLM 예산을 적용합니다. 로컬 기록만으로 충분하지 않을 때 자동 LLM 폴백이 트리거됩니다. 또는 언제든지 Ctrl+Space를 눌러 선호하는 로컬 또는 호스팅 LLM으로부터 지능적인 제안을 수동으로 가져올 수 있습니다.

💬 자연어 명령 모드

정확한 구문을 잊어버리세요. 원하는 것을 설명하기만 하면 됩니다. 다음과 같이 입력해 보세요: # 이 폴더에서 10MB보다 큰 모든 파일을 찾으려면 어떻게 해야 하나요?. Agensic은 3개의 복사 가능한 셸 명령을 생성하고 가장 가능성 높은 옵션을 다음 줄에 직접 삽입합니다. 명령 대신 안내가 필요하신가요? 도우미 모드를 사용하여 터미널에서 단계별 답변을 받으세요: ## macOS에 Node를 설치하려면 어떻게 해야 하나요?. 실행하기 전에 명령을 이해하고 싶나요? agensic --explain "명령어 입력"을 사용하세요.

🛡️ 네이티브 탭 보존 및 위험 차단

Agensic은 터미널을 존중합니다. 파일 경로나 스크립트를 완성할 때는 Tab을 그대로 두어 네이티브 셸 완성이 가장 잘하는 곳에서 승리하도록 합니다. 더 중요하게, 파괴적인 명령(예: rm -rf, mkfs, dd)은 제안 풀에서 엄격히 차단되어 실수로 재앙을 실행하지 않도록 합니다.

🌐 지원되는 제공자

Agensic은 로컬에서 모델을 실행하든 호스팅 엔드포인트를 사용하든 귀하의 스택에 맞춥니다.

• 로컬: Ollama, LM Studio
• 호스팅: OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker
• 사용자 정의: 모든 OpenAI 호환 엔드포인트
• 기록 전용: AI 호출 없이 로컬 명령 기록만 사용하여 완전히 오프라인으로 실행

🧰 사용 가능한 명령어

다음 표는 Agensic에서 현재 사용 가능한 모든 CLI 명령어를 나열합니다.

🔒 안전 및 개인정보 보호

Agensic은 최소 권한 및 최대 개인정보 보호 원칙에 따라 작동합니다:

• 로컬 인증: 모든 localhost API 경로는 자동 토큰 순환으로 엄격하게 인증됩니다.
• 비밀 정보 편집: 높은 엔트로피 값, URL 자격 증명 및 알려진 비밀 형식(예: AWS 키 또는 JWT)은 데이터가 LLM 호출을 위해 머신을 떠나기 전에 제거되고 편집됩니다.
• 명령 가드레일: 파괴적인 명령은 제안 엔진과 피드백 루프 모두에서 엄격히 차단됩니다.
• 속도 제한: 아웃바운드 LLM 호출은 API 남용을 방지하기 위해 엄격한 시간 초과 및 예산으로 제한됩니다.

👤 프로젝트 제작자

Alessio Leodori

🤝 지원

Agensic이 유용하신가요? 저장소에 ⭐️를 눌러주시고 친구에게 알려주세요! 이는 우리가 성장하는 데 도움이 됩니다 🌱

📄 라이선스

Agensic은 오픈소스이며 Apache-2.0 라이선스에 따라 라이선스가 부여됩니다.