agensic

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12868/4480e118bb0f8f08f64f7da7573729d0dc6641679e7781e4c4050d939ea4d1b2.png" alt="Agensic लोगो" width="100%" />
</p>

<h2 align="center">जानें क्या चला, कहाँ, कब और किसने इसे निष्पादित किया</h2>

<h3 align="center">AI-संचालित टर्मिनल वर्कफ़्लो के लिए अनुपस्थित अवलोकन क्षमता परत</h3>

<p align="center">
  <code>हस्ताक्षरित उद्गम (Signed Provenance)</code>
  <code>ट्रैक किए गए सत्र (Tracked Sessions)</code>
  <code>Git समय यात्रा (Git Time Travel)</code>
  <code>पुनः चलाने योग्य सत्र (Replayable Sessions)</code>
  <code>IDE-शैली टैब स्वतः पूर्णता (IDE style Tab Autocomplete)</code>
</p>

---

Agensic आपके मौजूदा टर्मिनल वर्कफ़्लो को AI युग के लिए उन्नत करता है। यह उन डेवलपर्स के लिए बनाया गया है जो अपने शेल में AI एजेंटों की उत्पादकता को बढ़ावा चाहते हैं, लेकिन **ऑडिट क्षमता, नियंत्रण और गोपनीयता** पर समझौता करने से इनकार करते हैं।

जैसे-जैसे AI एजेंट कमांड लाइन पर अधिक नियंत्रण लेते हैं और स्वायत्त रूप से कार्य निष्पादित करते हैं, दृश्यता और नियंत्रण महत्वपूर्ण हो जाता है।
Agensic **टर्मिनल कमांड को प्रथम श्रेणी के नागरिक** के रूप में मानता है और उन्हें ट्रैक करने, निरीक्षण करने और प्रबंधित करने के लिए एक मजबूत ढाँचा प्रदान करता है।

सभी टर्मिनल गतिविधियों को एक अस्पष्ट "शेल हिस्ट्री" में समतल करने के बजाय, Agensic एक फोरेंसिक पर्यवेक्षक और एक स्मार्ट सह-पायलट के रूप में कार्य करता है। यह इंटरैक्टिव AI कोडिंग सत्रों को सहजता से ट्रैक करता है, एजेंट द्वारा निष्पादित कमांड पर क्रिप्टोग्राफ़िक रूप से हस्ताक्षर करता है, और तेज़, हिस्ट्री-समर्थित IDE-शैली टैब स्वतः पूर्णता प्रदान करता है।

---

## 📋 विषय सूची

1. [प्लेटफ़ॉर्म समर्थन](#-प्लेटफ़ॉर्म-समर्थन)
2. [स्थापना](#-स्थापना)
3. [त्वरित आरंभ](#-त्वरित-आरंभ)
4. [Agensic उद्गम (Provenance)](#-agensic-उद्गम)
   - [विशेषताएँ](#-विशेषताएँ-उद्गम)
   - [समर्थित लेबल](#-समर्थित-लेबल)
5. [Agensic सत्र (Sessions)](#-agensic-सत्र)
   - [विशेषताएँ](#-विशेषताएँ-सत्र)
   - [समर्थित एजेंट](#-समर्थित-एजेंट)
6. [Agensic स्वतः पूर्णता (Autocomplete)](#-agensic-स्वतः-पूर्णता)
   - [विशेषताएँ](#-विशेषताएँ-स्वतः-पूर्णता)
   - [समर्थित प्रदाता](#-समर्थित-प्रदाता)
7. [उपलब्ध कमांड](#-उपलब्ध-कमांड)
8. [सुरक्षा और गोपनीयता](#-सुरक्षा-और-गोपनीयता)
9. [परियोजना निर्माता](#-परियोजना-निर्माता)
10. [समर्थन](#-समर्थन)
11. [लाइसेंस](#-लाइसेंस)

---

## 💻 <a id="-platform-support"></a>प्लेटफ़ॉर्म समर्थन

Agensic आपके शेल वातावरण में गहराई से एकीकृत होने के लिए डिज़ाइन किया गया है।

- macOS (Zsh) — पूरी तरह से समर्थित ✅

- Linux (Bash) — पूरी तरह से समर्थित ✅

---

## 🚀 <a id="-installation"></a>स्थापना

सबसे तेज़ तरीका प्रबंधित एक-लाइन इंस्टालर है:

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

यदि आप मैन्युअल रूप से क्लोन करना पसंद करते हैं:

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

यदि आपके पास पहले से `uv` है, तो इंस्टालर तेज़ सेटअप के लिए स्वचालित रूप से इसका उपयोग करेगा।

पहली बार चलाने पर, Agensic आपको अपना पसंदीदा LLM प्रदाता चुनने और कमांड स्वतः पूर्णता के लिए अपनी API कुंजियाँ कॉन्फ़िगर करने का संकेत देगा।

वैकल्पिक रूप से, आप यह चलाकर अपने LLM प्रदाता और API कुंजियाँ कॉन्फ़िगर कर सकते हैं:

```bash
agensic setup
```

## ⚡ <a id="-quick-start"></a>त्वरित आरंभ

सेटअप के बाद, **एक नया टर्मिनल खोलें** और Agensic स्वचालित रूप से आपकी टर्मिनल गतिविधि को ट्रैक करना शुरू कर देगा और जैसे ही आप टाइप करेंगे, स्वतः पूर्णता सुझाव प्रदान करेगा!

### 🤖 सहज एजेंट स्वतः-ट्रैकिंग

अपने सामान्य तरीके से काम करना शुरू करें, उदाहरण के लिए अपने पसंदीदा AI कोडिंग असिस्टेंट, जैसे Claude Code, Codex CLI, आदि का उपयोग करें:

```bash
claude
```

या

```bash
codex
```

सभी समर्थित एजेंटों की पूरी सूची के लिए [समर्थित एजेंट](#-समर्थित-एजेंट) अनुभाग देखें। यदि आपका एजेंट सूची में नहीं है, तो आप इसे <code>agensic --add_agent "executable"</code> चलाकर जोड़ सकते हैं और फिर इसका सामान्य रूप से उपयोग कर सकते हैं ताकि Agensic इसे ट्रैक कर सके।

समाप्त होने के बाद, आप सत्र इतिहास का निरीक्षण करने के लिए Agensic का उपयोग कर सकते हैं:

```bash
agensic sessions
```

या फोरेंसिक उद्गम देखने के लिए:

```bash
agensic provenance
```

---

## 🧾 <a id="-agensic-provenance"></a>Agensic उद्गम (Provenance)

Agensic आपको प्रत्येक कमांड के लिए एक फोरेंसिक ट्रांसक्रिप्ट देता है। यह वर्गीकृत करता है कि क्या हुआ, समृद्ध मेटाडेटा रिकॉर्ड करता है और एक स्पष्ट ऑडिट ट्रेल प्रस्तुत करता है ताकि आप बता सकें कि कोई कमांड मैन्युअल रूप से टाइप किया गया था, सुझाव से स्वीकार किया गया था या सीधे किसी एजेंट द्वारा निष्पादित किया गया था।

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12868/954db235102e042437af9e18befe1d48176d543e55a5bd8ba5cc3ff7a8396f41.gif" alt="Agensic उद्गम डेमो" width="75%" />
</p>

### <a id="-features-provenance"></a>✨ विशेषताएँ

### 🔍 पूर्ण-स्क्रीन उद्गम एक्सप्लोरर

<p>
"यहाँ वास्तव में क्या चला और किसने इसे ट्रिगर किया?" इसका उत्तर देने की आवश्यकता है? <code>agensic provenance</code> चलाकर पूर्ण-स्क्रीन उद्गम दर्शक खोलें। लेबल, एजेंट, प्रदाता या समय विंडो के अनुसार फ़िल्टर करें, सटीक कमांड ट्रेल का निरीक्षण करें और डिबगिंग, घटना समीक्षा या अनुपालन के लिए टिकाऊ रिकॉर्ड की आवश्यकता होने पर वर्तमान दृश्य को JSON या CSV में निर्यात करें।
</p>

### 🛡️ क्रिप्टोग्राफ़िक कमांड उद्गम और हस्ताक्षर

<p>
अंदाज़ा लगाना बंद करें कि किसने बिल्ड तोड़ा – मानव या AI। Agensic प्रत्येक कमांड के लिए समृद्ध मेटाडेटा कैप्चर करता है और एजेंट-निष्पादित रनों को एक अखंडनीय <code>AI_EXECUTED</code> लेबल के साथ टैग करने के लिए स्थानीय Ed25519 हस्ताक्षर का उपयोग करता है। आपको मानव कीस्ट्रोक्स को AI सुझावों और स्वचालित निष्पादन से अलग करने वाली एक स्पष्ट, ऑडिट करने योग्य समयरेखा मिलती है।
</p>

### 🏷️ संरचित आरोपण लेबल

<p>
Agensic टर्मिनल इतिहास को स्ट्रिंग्स की कच्ची सूची में कम नहीं करता है। प्रत्येक ट्रैक किए गए कमांड को एक उद्गम लेबल में वर्गीकृत किया जाता है, जो आपको रनों को फ़िल्टर करने, व्यवहार की जाँच करने और यह समझने का एक सुसंगत तरीका देता है कि कोई कमांड आपके शेल में कैसे आया।
</p>

### <a id="-supported-labels"></a>🔖 समर्थित लेबल

Agensic वर्तमान में निम्नलिखित उद्गम लेबल का समर्थन करता है:

- <code>AI_EXECUTED</code> उन कमांडों के लिए जो सीधे AI एजेंट द्वारा हस्ताक्षरित प्रमाण के साथ निष्पादित किए गए थे
- <code>HUMAN_TYPED</code> उन कमांडों के लिए जो शेल में मनुष्य द्वारा मैन्युअल रूप से टाइप किए गए थे
- <code>AI_SUGGESTED_HUMAN_RAN</code> उन कमांडों के लिए जो बाहरी AI LLM कॉल द्वारा सुझाए गए थे और फिर मनुष्य द्वारा चलाए गए थे
- <code>AG_SUGGESTED_HUMAN_RAN</code> उन कमांडों के लिए जो Agensic द्वारा सुझाए गए थे और फिर मनुष्य द्वारा चलाए गए थे
- <code>INVALID_PROOF</code> उन कमांडों के लिए जो प्रमाण मेटाडेटा के साथ आए जो सत्यापन में विफल रहे
- <code>UNKNOWN</code> उन कमांडों के लिए जहाँ उपलब्ध साक्ष्य एक मजबूत आरोपण लेबल निर्दिष्ट करने के लिए अपर्याप्त हैं

---

## 🕵️‍♂️ <a id="-agensic-sessions"></a>Agensic सत्र (Sessions)

Agensic इंटरैक्टिव एजेंट सत्र रिकॉर्ड करता है, जो आपको यह अखंडनीय प्रमाण देता है कि क्या हुआ और Time Travel सुविधा के माध्यम से रेपो स्थिति को सुरक्षित रूप से बदलने की क्षमता प्रदान करता है।

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12868/5a2de01b27f96092f2a728dcd93c9368336747306cea978c81b18ad3b6714f5e.gif" alt="Agensic रीप्ले डेमो" width="75%" />
</p>

### <a id="-features-sessions"></a>✨ विशेषताएँ

### ▶️ पुनः चलाने योग्य सत्र

<p>
पिछली रात के सत्र का ऑडिट करने की आवश्यकता है, यह समझने के लिए कि क्या हुआ? <code>agensic sessions</code> चलाएँ और उस सत्र का चयन करें जिसे आप फिर से चलाना चाहते हैं। हमारा तेज़, पूर्ण-स्क्रीन TUI आपको तुरंत समयसीमा ब्राउज़ करने, पेलोड का निरीक्षण करने और सत्र को फिर से चलाने की अनुमति देता है। जब आपको किसी घटना समीक्षा के लिए साक्ष्य साझा करने की आवश्यकता हो, तो एक कीस्ट्रोक में सटीक डेटासेट को JSON या CSV में निर्यात करें।
</p>

### ⏪ समय यात्रा (Time Travel)

<p>
कभी सोचा है, "एजेंट द्वारा विनाशकारी कमिट करने से ठीक पहले मेरा रेपो कैसा दिखता था?" Time Travel आपको अपने रिपॉजिटरी को एक विशिष्ट सत्र चेकपॉइंट पर कैप्चर की गई सटीक Git स्थिति में वापस ले जाने देता है। Agensic बिना ट्रैक की गई और संशोधित फ़ाइलों को एक नई शाखा में सुरक्षित रूप से पुनर्स्थापित करता है, यह सुनिश्चित करता है कि जाँच करते समय आप गलती से अपने लाइव वर्किंग ट्री को नष्ट न करें।
</p>

### 🗄️ लचीला स्थानीय-प्रथम स्थिति

<p>
आपका डेटा आपका रहता है। Agensic एक मजबूत SQLite स्थिति बैकएंड का उपयोग करता है जिसमें केवल-जोड़ें ईवेंट जर्नल और स्वचालित स्नैपशॉटिंग शामिल है। इसका मतलब है कि आपका फोरेंसिक इतिहास अप्रत्याशित टर्मिनल क्रैश, सिस्टम रीबूट और लंबे समय तक स्थानीय उपयोग को बिना भ्रष्टाचार के सहन करता है।
</p>

### <a id="-supported-agents"></a>🤖 समर्थित एजेंट

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 setup में कोई भी एजेंट निष्पादन योग्य डालें और यह बिना किसी कॉन्फ़िगरेशन के तुरंत काम करेगा

---

## ⚡ <a id="-agensic-autocomplete"></a>Agensic स्वतः पूर्णता (Autocomplete)

Agensic टर्मिनल सुझावों की पुनर्कल्पना करता है। संदर्भ-जागरूक, शब्दार्थ और हमेशा तेज़ IDE-शैली, संतोषजनक Tab स्वतः पूर्णता।

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/12868/f710d6a7c01b14691b1d825894e1640c2a92ff1642178a5aed2b3d7d0ac241e3.gif" alt="Agensic स्वतः पूर्णता डेमो" width="50%" />
</p>

### <a id="-features-autocomplete"></a>✨ विशेषताएँ

### 🚀 बेहद तेज़ स्थानीय इतिहास सुझाव

<p>
इनपुट विलंब को अलविदा कहें। जैसे ही आप टाइप करते हैं, Agensic आपके वास्तविक कमांड इतिहास के स्टोर से क्वेरी करता है। सुझाव तुरंत भूत पाठ के रूप में प्रकट होते हैं, जिसे आप <code>Tab</code> से आसानी से स्वीकार कर सकते हैं। क्योंकि यह आपके पैटर्न से सीखता है और आप वास्तव में क्या करते हैं उस पर निर्भर करता है, सुझाव अत्यधिक सटीक और रेपो-जागरूक होते हैं।
</p>

### 🧠 शब्दार्थ खोज और टाइपो पुनर्प्राप्ति

<p>
इंसान गलतियाँ करते हैं, Agensic उन्हें ठीक करता है। यदि आप <code>dokcer</code> टाइप करते हैं, तो Agensic तुरंत <code>क्या आपका मतलब है: docker</code> सुझाव देता है। सटीक सिंटैक्स याद नहीं है? शब्दार्थ पुनर्क्रमण आपकी मंशा को बचाता है, सही कमांड ढूँढता है भले ही आपका उपसर्ग पूरी तरह से मेल न खाए: यदि आप <code>docker records</code> टाइप करते हैं तो आपको <code>क्या आपका मतलब है: docker logs</code> मिलेगा (बशर्ते आपने अतीत में <code>docker logs</code> चलाया हो)
</p>

### 💡 मांग पर AI बैकअप

<p>
AI एक शक्तिशाली बैकअप है, हर कीस्ट्रोक पर कर नहीं। Agensic प्रॉम्प्ट स्पैम को रोकने के लिए प्रति-पंक्ति LLM बजट लागू करता है। जब स्थानीय इतिहास पर्याप्त नहीं है, तो स्वचालित LLM बैकअप ट्रिगर हो जाएगा। वैकल्पिक रूप से, आप हमेशा अपने पसंदीदा स्थानीय या होस्ट किए गए LLM से एक बुद्धिमान सुझाव प्राप्त करने के लिए <code>Ctrl+Space</code> दबा सकते हैं।
</p>

### 💬 प्राकृतिक भाषा कमांड मोड

<p>
सटीक सिंटैक्स भूल जाएँ, बस वर्णन करें कि आप क्या चाहते हैं। कुछ इस तरह टाइप करें: <code># मैं इस फ़ोल्डर में 10MB से बड़ी सभी फ़ाइलें कैसे ढूँढ सकता हूँ?</code>। Agensic 3 कॉपी-रेडी शेल कमांड उत्पन्न करता है और सबसे संभावित विकल्प को सीधे आपकी अगली पंक्ति में सम्मिलित करता है। कमांड के बजाय मार्गदर्शन चाहिए? सहायक मोड का उपयोग करके सीधे अपने टर्मिनल में चरण-दर-चरण उत्तर प्राप्त करें: <code>## मैं macOS पर Node कैसे स्थापित करूँ?</code>। चलाने से पहले किसी कमांड को समझना चाहते हैं? इसका उपयोग करें: <code>agensic --explain "आपका कमांड यहाँ"</code>
</p>

### 🛡️ मूल Tab संरक्षण और जोखिम अवरोधन

<p>
Agensic आपके टर्मिनल का सम्मान करता है। जब आप फ़ाइल पथ या स्क्रिप्ट पूरी कर रहे हों तो यह <code>Tab</code> को अकेला छोड़ देता है, ताकि मूल शेल पूर्णता वहाँ जीते जहाँ यह सबसे अच्छा है। अधिक महत्वपूर्ण बात, विनाशकारी कमांड (जैसे <code>rm -rf</code>, <code>mkfs</code>, या <code>dd</code>) सुझाव पूल से सख्ती से अवरुद्ध हैं ताकि आप गलती से कोई आपदा निष्पादित न करें।
</p>

### <a id="-supported-providers"></a>🌐 समर्थित प्रदाता

Agensic आपके स्टैक में फिट बैठता है, चाहे आप मॉडल स्थानीय रूप से चलाएँ या होस्ट किए गए एंडपॉइंट का उपयोग करें।

- **स्थानीय:** Ollama, LM Studio
- **होस्ट किया गया:** OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker
- **कस्टम:** कोई भी OpenAI-संगत एंडपॉइंट
- **केवल इतिहास:** AI कॉल के बिना पूरी तरह से ऑफलाइन चलाएँ, केवल अपने स्थानीय कमांड इतिहास का उपयोग करके

## 🧰 <a id="-available-commands"></a>उपलब्ध कमांड

नीचे दी गई तालिका Agensic में वर्तमान में उपलब्ध प्रत्येक CLI कमांड को सूचीबद्ध करती है।

| कमांड                             | यह क्या करता है                                                                                                                               |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <code>agensic --help</code>         | मुख्य CLI सहायता और सभी मानक उपयोगकर्ता-सामना वाले कमांड दिखाएँ                                                                               |
| <code>agensic --version</code>      | स्थापित Agensic संस्करण प्रिंट करें और बाहर निकलें                                                                                               |
| <code>agensic update</code>         | नवीनतम प्रकाशित Agensic GitHub रिलीज़ डाउनलोड और इंस्टॉल करें                                                                           |
| <code>agensic setup</code>          | Agensic सत्र और स्वतः पूर्णता के लिए इंटरैक्टिव सेटअप फ़्लो खोलें                                                                      |
| <code>agensic enable-startup</code> | लॉगिन या बूट पर स्वचालित रूप से शुरू होने के लिए Agensic कॉन्फ़िगर करें                                                                                  |
| <code>agensic first-run</code>      | पहली-स्थापना ऑनबोर्डिंग फ़्लो चलाएँ                                                                                                      |
| <code>agensic start</code>          | Agensic बैकग्राउंड डेमॉन मैन्युअल रूप से शुरू करें                                                                                               |
| <code>agensic stop</code>           | Agensic डेमॉन रोकें                                                                                                                    |
| <code>agensic logs</code>           | डेमॉन लॉग आउटपुट को रीयल टाइम में टेल करें                                                                                                    |
| <code>agensic test</code>           | कनेक्टिविटी सत्यापित करने के लिए डेमॉन को एक परीक्षण स्वतः पूर्णता अनुरोध भेजें                                                                      |
| <code>agensic provenance</code>     | कमांड उद्गम इतिहास दृश्य खोलें। <code>--limit</code>, <code>--label</code>, और <code>--contains</code> जैसे फ़िल्टर का समर्थन करता है |
| <code>agensic sessions</code>       | ट्रैक किए गए सत्र ब्राउज़र खोलें। सादा टेक्स्ट आउटपुट के लिए <code>--text</code> का उपयोग करें                                                           |

## 🔒 <a id="-safety--privacy"></a>सुरक्षा और गोपनीयता

Agensic न्यूनतम विशेषाधिकार और अधिकतम गोपनीयता के सिद्धांत पर काम करता है:

- **स्थानीय प्रमाणीकरण:** प्रत्येक लोकलहोस्ट API रूट स्वचालित टोकन रोटेशन के साथ सख्ती से प्रमाणित है
- **गुप्त संपादन:** उच्च-एंट्रॉपी मान, URL क्रेडेंशियल और ज्ञात गुप्त प्रारूप (जैसे AWS कुंजियाँ या JWT) को किसी भी डेटा के LLM कॉल के लिए आपकी मशीन छोड़ने से **पहले** हटा दिया और संपादित किया जाता है
- **कमांड गार्डरेल:** विनाशकारी कमांड सुझाव इंजन और फीडबैक लूप दोनों से कड़ाई से अवरुद्ध हैं
- **दर सीमित:** आउटबाउंड LLM कॉल API दुरुपयोग को रोकने के लिए सख्त टाइमआउट और बजट द्वारा बाध्य हैं

---

## <a id="-project-creator"></a>👤 परियोजना निर्माता

एलेसियो लियोडोरी

## <a id="-support"></a>🤝 समर्थन

Agensic उपयोगी लगता है? रेपो को स्टार ⭐️ करें और एक दोस्त को बताएँ! इससे हमें बढ़ने में मदद मिलेगी 🌱

## 📄 <a id="-license"></a>लाइसेंस

Agensic ओपन-सोर्स है और **Apache-2.0 लाइसेंस** के तहत लाइसेंस प्राप्त है।