auto-context-cli 1.0.0__tar.gz → 1.0.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/PKG-INFO +85 -10
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/README.md +84 -9
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/pyproject.toml +1 -1
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/__init__.py +1 -1
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/init_cmd.py +41 -0
- auto_context_cli-1.0.2/src/auto_context/commands/memory.py +320 -0
- auto_context_cli-1.0.2/src/auto_context/commands/update_cmd.py +392 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/config.py +28 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/main.py +16 -3
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/AGENTS.template.md +8 -4
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/GEMINI.template.md +8 -4
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/maintain_context.template.md +5 -4
- auto_context_cli-1.0.0/src/auto_context/commands/memory.py +0 -236
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/.gitignore +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/LICENSE +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/__init__.py +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/import_cmd.py +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/mcp.py +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/commands/share.py +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/security.py +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/context.local.template.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/context.template.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/mcp_config.template.json +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/profile.template.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/rule.template.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/rules/code-standards.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/rules/security-boundaries.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skill.template.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/browser-testing/SKILL.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/docker-ops/SKILL.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/git-workflow/SKILL.md +0 -0
- {auto_context_cli-1.0.0 → auto_context_cli-1.0.2}/src/auto_context/templates/skills/server-diagnostics/SKILL.md +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: auto-context-cli
|
|
3
|
-
Version: 1.0.
|
|
3
|
+
Version: 1.0.2
|
|
4
4
|
Summary: Autonomous context & instruction manager for AI coding assistants
|
|
5
5
|
Author: Arghya Biswas
|
|
6
6
|
License: MIT
|
|
@@ -18,10 +18,12 @@ Description-Content-Type: text/markdown
|
|
|
18
18
|
|
|
19
19
|
**Autonomous Context & Instruction Management Protocol for AI Coding Assistants**
|
|
20
20
|
|
|
21
|
+
[](https://pypi.org/project/auto-context-cli/)
|
|
22
|
+
[](https://pypi.org/project/auto-context-cli/)
|
|
23
|
+
[](https://github.com/Cyber-arghya/auto-context/releases/tag/v1.0.2)
|
|
21
24
|
[](https://opensource.org/licenses/MIT)
|
|
22
|
-
[](#-quick-one-line-install)
|
|
23
26
|
[](#-supported-ai-assistants)
|
|
24
|
-
[](https://github.com/Cyber-arghya/auto-context/pulls)
|
|
25
27
|
|
|
26
28
|
*Never lose context, forgotten architecture decisions, or unlogged bug fixes again.*
|
|
27
29
|
|
|
@@ -33,19 +35,26 @@ Description-Content-Type: text/markdown
|
|
|
33
35
|
|
|
34
36
|
## ⚡ Quick One-Line Install
|
|
35
37
|
|
|
36
|
-
No manual
|
|
38
|
+
No manual git clones or complex PATH configurations required. Install directly via PyPI or using our 1-click installer:
|
|
37
39
|
|
|
38
|
-
### 📦
|
|
40
|
+
### 📦 Direct via PyPI (Universal - Windows, macOS, Linux, WSL2):
|
|
39
41
|
```bash
|
|
40
|
-
uv
|
|
42
|
+
# Recommended via uv (fast & isolated):
|
|
43
|
+
uv tool install auto-context-cli
|
|
44
|
+
|
|
45
|
+
# Or via standard pip:
|
|
46
|
+
pip install auto-context-cli
|
|
47
|
+
|
|
48
|
+
# Or via pipx:
|
|
49
|
+
pipx install auto-context-cli
|
|
41
50
|
```
|
|
42
51
|
|
|
43
|
-
### 🪟 Windows (PowerShell / `pwsh` 1-Click):
|
|
52
|
+
### 🪟 Windows (PowerShell / `pwsh` 1-Click Installer):
|
|
44
53
|
```powershell
|
|
45
54
|
irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
|
|
46
55
|
```
|
|
47
56
|
|
|
48
|
-
### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click):
|
|
57
|
+
### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click Installer):
|
|
49
58
|
```bash
|
|
50
59
|
curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
|
|
51
60
|
```
|
|
@@ -86,6 +95,11 @@ OPTIONS (CENTRAL MEMORY & GRANULAR SHARING):
|
|
|
86
95
|
memory status Show status of central memory brain
|
|
87
96
|
share <NAME> Audit & publish skill or rule to GitHub Gist
|
|
88
97
|
import <URL> Audit & import skill or rule from GitHub Gist or URL
|
|
98
|
+
update Safely update CLI, global plugin & public rules (Non-breaking)
|
|
99
|
+
update --check Check for updates without modifying files
|
|
100
|
+
update -w, --workspace Update managed system rules in active workspace
|
|
101
|
+
update -g, --global Sync global plugin (~/.gemini/config/plugins/auto-context/)
|
|
102
|
+
update -c, --cli Upgrade auto-context-cli package via uv/pipx/pip
|
|
89
103
|
--as <NAME> Custom name when importing a skill or rule
|
|
90
104
|
--public Publish shared Gist as public (default)
|
|
91
105
|
--secret, --private Publish shared Gist as unlisted/secret
|
|
@@ -103,6 +117,38 @@ OPTIONS (MCP TOOLING):
|
|
|
103
117
|
|
|
104
118
|
---
|
|
105
119
|
|
|
120
|
+
## 🔄 Modular Upstream Sync & Non-Breaking Updates (আপডেট ও সিঙ্ক)
|
|
121
|
+
|
|
122
|
+
When new public rules, skills, or agent capabilities are added to the official [Cyber-arghya/auto-context](https://github.com/Cyber-arghya/auto-context) repository:
|
|
123
|
+
|
|
124
|
+
### 1️⃣ Automatic Background Notification
|
|
125
|
+
`auto-context` includes a lightweight, cached (24h TTL) update notifier. Whenever you or an AI agent runs `init-context`, it unobtrusively checks PyPI and GitHub. If new upstream rules or versions are available, a clean banner is displayed:
|
|
126
|
+
```text
|
|
127
|
+
╭─────────────────────────────────────────────────────────────────────────────╮
|
|
128
|
+
│ 🔔 Auto-Context Update Available: v1.0.1 → v1.0.2 │
|
|
129
|
+
│ New public rules, skills, and upstream capabilities are ready. │
|
|
130
|
+
│ Run 'init-context update' to sync modularly without breaking local context.│
|
|
131
|
+
╰─────────────────────────────────────────────────────────────────────────────╯
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### 2️⃣ 1-Command Safe Modular Update
|
|
135
|
+
Run:
|
|
136
|
+
```bash
|
|
137
|
+
init-context update
|
|
138
|
+
```
|
|
139
|
+
- **Upgrades CLI Package:** Automatically updates `auto-context-cli` via `uv tool`, `pipx`, or `pip`.
|
|
140
|
+
- **Syncs Global Plugin:** Updates `~/.gemini/config/plugins/auto-context/` (`rules/AGENTS.md`, `skills/auto-context/SKILL.md`) with upstream instructions.
|
|
141
|
+
- **Syncs Workspace System Rules:** Updates system rules (`.agents/rules/maintain_context.md`, `AGENTS.md`, `GEMINI.md`).
|
|
142
|
+
|
|
143
|
+
> [!TIP]
|
|
144
|
+
> **Strict Non-Breaking Guarantees:**
|
|
145
|
+
> - **Zero Context Loss:** `context.md` is **NEVER** modified or overwritten. All project credentials, architecture diagrams, and problem history remain 100% intact.
|
|
146
|
+
> - **Secret Protection:** `context.local.md`, `.env`, and test logins are **NEVER** touched.
|
|
147
|
+
> - **Custom Rule Safety:** Your personal rules (e.g. `docker-multi-stage.md`, `my-style.md`) are **NEVER** overwritten or deleted.
|
|
148
|
+
> - **Automatic Backup:** If you customized `AGENTS.md`, the updater automatically creates an `AGENTS.md.bak` backup.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
106
152
|
## 🔌 MCP (Model Context Protocol) Tooling Management (টুল ম্যানেজমেন্ট)
|
|
107
153
|
|
|
108
154
|
Auto-Context allows you and your AI agents to seamlessly install, update, list, and delete **MCP servers** with single commands:
|
|
@@ -184,6 +230,11 @@ You can easily teach your AI assistants new abilities (**Skills**) or enforce cu
|
|
|
184
230
|
| **Rule** | Behavioral constraints, coding standards, security boundaries, or test requirements. | Always active (`trigger: always_on`) or context-triggered. | `.agents/rules/<name>.md` or `GEMINI.md` |
|
|
185
231
|
| **Skill** | Step-by-step procedures, deployment runbooks, debugging steps, or CLI tool guides. | Activated on-demand when relevant task is requested. | `.agents/skills/<name>/SKILL.md` |
|
|
186
232
|
|
|
233
|
+
> [!IMPORTANT]
|
|
234
|
+
> **Core Directives for AI Coding Agents:**
|
|
235
|
+
> - **Zero Token Waste:** DO NOT burn tokens manually searching directories or reading files to check for existing rules. Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
|
|
236
|
+
> - **Mandatory Global Scope:** When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
|
|
237
|
+
|
|
187
238
|
---
|
|
188
239
|
|
|
189
240
|
### 1️⃣ How to Add a New Rule
|
|
@@ -454,11 +505,17 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
|
|
|
454
505
|
3. **পাসওয়ার্ড ও পোর্ট ভল্ট:** সার্ভারের স্ট্যাটিক আইপি, ক্লাউডফ্লেয়ার টানেল আইডি বা ডাটাবেজ পোর্ট সবসময় এক ফাইলে নিখুঁতভাবে থাকবে।
|
|
455
506
|
|
|
456
507
|
### ইনস্টলেশন ও ব্যবহার:
|
|
457
|
-
*
|
|
508
|
+
* **PyPI থেকে সরাসরি ইনস্টল করতে (সবার জন্য সহজ):**
|
|
509
|
+
```bash
|
|
510
|
+
pip install auto-context-cli
|
|
511
|
+
# অথবা uv দিয়ে:
|
|
512
|
+
uv tool install auto-context-cli
|
|
513
|
+
```
|
|
514
|
+
* **উইন্ডোজ পাওয়ারশেল (1-Click Installer):**
|
|
458
515
|
```powershell
|
|
459
516
|
irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
|
|
460
517
|
```
|
|
461
|
-
* **লিনাক্স / WSL2
|
|
518
|
+
* **লিনাক্স / WSL2 / macOS (1-Click Installer):**
|
|
462
519
|
```bash
|
|
463
520
|
curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
|
|
464
521
|
```
|
|
@@ -470,6 +527,10 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
|
|
|
470
527
|
ব্যস! আপনার প্রজেক্টে স্বয়ংক্রিয় কনটেক্সট ট্র্যাকিং চালু হয়ে যাবে।
|
|
471
528
|
|
|
472
529
|
### নতুন স্কিল বা রুল তৈরি করার নিয়ম:
|
|
530
|
+
> [!IMPORTANT]
|
|
531
|
+
> **এআই কোডিং এজেন্টের জন্য বাধ্যতামূলক নির্দেশিকা:**
|
|
532
|
+
> - **জিরো টোকেন অপচয় (Zero Token Waste):** কোনো রুল বা স্কিল আগে থেকে আছে কিনা তা চেক করতে ম্যানুয়ালি ফাইল খোঁজা বা পড়ার কোনো প্রয়োজন নেই। সরাসরি `init-context -r <name> [-g]` রান করুন — সিএলআই স্বয়ংক্রিয়ভাবে ডুপ্লিকেট শনাক্ত ও কলিশন গার্ড দিয়ে প্রোটেক্ট করে।
|
|
533
|
+
> - **বাধ্যতামূলক গ্লোবাল স্কোপ (Mandatory Global Scope):** ইউজার যখন "for future", "always" বা ভবিষ্যতের জন্য কোনো সাধারণ নিয়ম সেভ করতে বলবে, তখন অবশ্যই `--global` (`-g`) ব্যবহার করতে হবে এবং সাথে সাথে `init-context memory push` রান করে সেন্ট্রাল মেমরিতে সিঙ্ক করতে হবে।
|
|
473
534
|
* **নতুন রুল (Rule) তৈরি করতে:**
|
|
474
535
|
```bash
|
|
475
536
|
init-context -r my-rule-name # বর্তমান প্রজেক্টের জন্য
|
|
@@ -513,6 +574,20 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
|
|
|
513
574
|
```
|
|
514
575
|
> **কলিশন গার্ড:** যদি একই নামের কোনো স্কিল আগে থেকেই থেকে থাকে, তবে এটি না জানিয়ে কখনো ওভাররাইট করবে না। টার্মিনালে আপনাকে ৩টি অপশন দেবে: `[O]verwrite / [R]ename / [C]ancel`।
|
|
515
576
|
|
|
577
|
+
### 🔄 মডুলার আপস্ট্রিম আপডেট ও স্বয়ংক্রিয় নোটিফিকেশন (Update & Sync):
|
|
578
|
+
অফিশিয়াল গিটহাব রিপোজিটরিতে নতুন কোনো রুলবুক, স্কিল বা এআই এজেন্ট টুল যুক্ত হলে ব্যবহারকারীরা খুব সহজে আপডেট পেতে পারেন:
|
|
579
|
+
1. **স্বয়ংক্রিয় নোটিফিকেশন ব্যানার:** চব্বিশ ঘণ্টায় একবার ব্যাকগ্রাউন্ডে চেক করে নতুন রুল আসলে টার্মিনালে সুন্দর নোটিফিকেশন দেখাবে।
|
|
580
|
+
2. **এক কমান্ডে নিরাপদ আপডেট (`init-context update`):**
|
|
581
|
+
```bash
|
|
582
|
+
init-context update # ফুল মডুলার আপডেট (CLI + গ্লোবাল প্লাগইন + সিস্টেম রুলস)
|
|
583
|
+
init-context update --check # কোনো আপডেট আছে কিনা শুধু চেক করতে
|
|
584
|
+
init-context update -w # শুধুমাত্র বর্তমান প্রজেক্টের সিস্টেম রুলস আপডেট করতে
|
|
585
|
+
```
|
|
586
|
+
> **ব্রেকিং-চেঞ্জ মুক্ত সুরক্ষা (Zero Breaking Guarantee):**
|
|
587
|
+
> * আপনার প্রজেক্টের `context.md`, `context.local.md` বা `.env` ফাইলে **কখনোই হাত দেওয়া হবে না**।
|
|
588
|
+
> * আপনার তৈরিকৃত কোনো কাস্টম রুল মুছে যাবে না।
|
|
589
|
+
> * কোনো ফাইলে কাস্টম পরিবর্তন থাকলে স্বয়ংক্রিয়ভাবে `.bak` ব্যাকআপ তৈরি হবে।
|
|
590
|
+
|
|
516
591
|
### নিরাপদ MCP টুল ম্যানেজমেন্ট (Secure Secrets via .env):
|
|
517
592
|
টোকেন বা পাসওয়ার্ড কখনোই কনফিগ ফাইলে ওপেন টেক্সটে সেভ হয় না, বরং `.env` এবং `.gitignore`-এর মাধ্যমে নিরাপদ থাকে:
|
|
518
593
|
* **টুল যুক্ত করতে (Node `npx` বা Python `uvx` সাপোর্ট):**
|
|
@@ -4,10 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
**Autonomous Context & Instruction Management Protocol for AI Coding Assistants**
|
|
6
6
|
|
|
7
|
+
[](https://pypi.org/project/auto-context-cli/)
|
|
8
|
+
[](https://pypi.org/project/auto-context-cli/)
|
|
9
|
+
[](https://github.com/Cyber-arghya/auto-context/releases/tag/v1.0.2)
|
|
7
10
|
[](https://opensource.org/licenses/MIT)
|
|
8
|
-
[](#-quick-one-line-install)
|
|
9
12
|
[](#-supported-ai-assistants)
|
|
10
|
-
[](https://github.com/Cyber-arghya/auto-context/pulls)
|
|
11
13
|
|
|
12
14
|
*Never lose context, forgotten architecture decisions, or unlogged bug fixes again.*
|
|
13
15
|
|
|
@@ -19,19 +21,26 @@
|
|
|
19
21
|
|
|
20
22
|
## ⚡ Quick One-Line Install
|
|
21
23
|
|
|
22
|
-
No manual
|
|
24
|
+
No manual git clones or complex PATH configurations required. Install directly via PyPI or using our 1-click installer:
|
|
23
25
|
|
|
24
|
-
### 📦
|
|
26
|
+
### 📦 Direct via PyPI (Universal - Windows, macOS, Linux, WSL2):
|
|
25
27
|
```bash
|
|
26
|
-
uv
|
|
28
|
+
# Recommended via uv (fast & isolated):
|
|
29
|
+
uv tool install auto-context-cli
|
|
30
|
+
|
|
31
|
+
# Or via standard pip:
|
|
32
|
+
pip install auto-context-cli
|
|
33
|
+
|
|
34
|
+
# Or via pipx:
|
|
35
|
+
pipx install auto-context-cli
|
|
27
36
|
```
|
|
28
37
|
|
|
29
|
-
### 🪟 Windows (PowerShell / `pwsh` 1-Click):
|
|
38
|
+
### 🪟 Windows (PowerShell / `pwsh` 1-Click Installer):
|
|
30
39
|
```powershell
|
|
31
40
|
irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
|
|
32
41
|
```
|
|
33
42
|
|
|
34
|
-
### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click):
|
|
43
|
+
### 🐧 Linux / WSL2 / macOS (Bash / Zsh 1-Click Installer):
|
|
35
44
|
```bash
|
|
36
45
|
curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
|
|
37
46
|
```
|
|
@@ -72,6 +81,11 @@ OPTIONS (CENTRAL MEMORY & GRANULAR SHARING):
|
|
|
72
81
|
memory status Show status of central memory brain
|
|
73
82
|
share <NAME> Audit & publish skill or rule to GitHub Gist
|
|
74
83
|
import <URL> Audit & import skill or rule from GitHub Gist or URL
|
|
84
|
+
update Safely update CLI, global plugin & public rules (Non-breaking)
|
|
85
|
+
update --check Check for updates without modifying files
|
|
86
|
+
update -w, --workspace Update managed system rules in active workspace
|
|
87
|
+
update -g, --global Sync global plugin (~/.gemini/config/plugins/auto-context/)
|
|
88
|
+
update -c, --cli Upgrade auto-context-cli package via uv/pipx/pip
|
|
75
89
|
--as <NAME> Custom name when importing a skill or rule
|
|
76
90
|
--public Publish shared Gist as public (default)
|
|
77
91
|
--secret, --private Publish shared Gist as unlisted/secret
|
|
@@ -89,6 +103,38 @@ OPTIONS (MCP TOOLING):
|
|
|
89
103
|
|
|
90
104
|
---
|
|
91
105
|
|
|
106
|
+
## 🔄 Modular Upstream Sync & Non-Breaking Updates (আপডেট ও সিঙ্ক)
|
|
107
|
+
|
|
108
|
+
When new public rules, skills, or agent capabilities are added to the official [Cyber-arghya/auto-context](https://github.com/Cyber-arghya/auto-context) repository:
|
|
109
|
+
|
|
110
|
+
### 1️⃣ Automatic Background Notification
|
|
111
|
+
`auto-context` includes a lightweight, cached (24h TTL) update notifier. Whenever you or an AI agent runs `init-context`, it unobtrusively checks PyPI and GitHub. If new upstream rules or versions are available, a clean banner is displayed:
|
|
112
|
+
```text
|
|
113
|
+
╭─────────────────────────────────────────────────────────────────────────────╮
|
|
114
|
+
│ 🔔 Auto-Context Update Available: v1.0.1 → v1.0.2 │
|
|
115
|
+
│ New public rules, skills, and upstream capabilities are ready. │
|
|
116
|
+
│ Run 'init-context update' to sync modularly without breaking local context.│
|
|
117
|
+
╰─────────────────────────────────────────────────────────────────────────────╯
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### 2️⃣ 1-Command Safe Modular Update
|
|
121
|
+
Run:
|
|
122
|
+
```bash
|
|
123
|
+
init-context update
|
|
124
|
+
```
|
|
125
|
+
- **Upgrades CLI Package:** Automatically updates `auto-context-cli` via `uv tool`, `pipx`, or `pip`.
|
|
126
|
+
- **Syncs Global Plugin:** Updates `~/.gemini/config/plugins/auto-context/` (`rules/AGENTS.md`, `skills/auto-context/SKILL.md`) with upstream instructions.
|
|
127
|
+
- **Syncs Workspace System Rules:** Updates system rules (`.agents/rules/maintain_context.md`, `AGENTS.md`, `GEMINI.md`).
|
|
128
|
+
|
|
129
|
+
> [!TIP]
|
|
130
|
+
> **Strict Non-Breaking Guarantees:**
|
|
131
|
+
> - **Zero Context Loss:** `context.md` is **NEVER** modified or overwritten. All project credentials, architecture diagrams, and problem history remain 100% intact.
|
|
132
|
+
> - **Secret Protection:** `context.local.md`, `.env`, and test logins are **NEVER** touched.
|
|
133
|
+
> - **Custom Rule Safety:** Your personal rules (e.g. `docker-multi-stage.md`, `my-style.md`) are **NEVER** overwritten or deleted.
|
|
134
|
+
> - **Automatic Backup:** If you customized `AGENTS.md`, the updater automatically creates an `AGENTS.md.bak` backup.
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
92
138
|
## 🔌 MCP (Model Context Protocol) Tooling Management (টুল ম্যানেজমেন্ট)
|
|
93
139
|
|
|
94
140
|
Auto-Context allows you and your AI agents to seamlessly install, update, list, and delete **MCP servers** with single commands:
|
|
@@ -170,6 +216,11 @@ You can easily teach your AI assistants new abilities (**Skills**) or enforce cu
|
|
|
170
216
|
| **Rule** | Behavioral constraints, coding standards, security boundaries, or test requirements. | Always active (`trigger: always_on`) or context-triggered. | `.agents/rules/<name>.md` or `GEMINI.md` |
|
|
171
217
|
| **Skill** | Step-by-step procedures, deployment runbooks, debugging steps, or CLI tool guides. | Activated on-demand when relevant task is requested. | `.agents/skills/<name>/SKILL.md` |
|
|
172
218
|
|
|
219
|
+
> [!IMPORTANT]
|
|
220
|
+
> **Core Directives for AI Coding Agents:**
|
|
221
|
+
> - **Zero Token Waste:** DO NOT burn tokens manually searching directories or reading files to check for existing rules. Directly run `init-context -r <name> [-g]` — the CLI has instant built-in duplicate detection and collision guards.
|
|
222
|
+
> - **Mandatory Global Scope:** When the user mentions "for future", "always", or defines a reusable standard, **MANDATORY: Always pass `--global` (`-g`)** and immediately follow with `init-context memory push`.
|
|
223
|
+
|
|
173
224
|
---
|
|
174
225
|
|
|
175
226
|
### 1️⃣ How to Add a New Rule
|
|
@@ -440,11 +491,17 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
|
|
|
440
491
|
3. **পাসওয়ার্ড ও পোর্ট ভল্ট:** সার্ভারের স্ট্যাটিক আইপি, ক্লাউডফ্লেয়ার টানেল আইডি বা ডাটাবেজ পোর্ট সবসময় এক ফাইলে নিখুঁতভাবে থাকবে।
|
|
441
492
|
|
|
442
493
|
### ইনস্টলেশন ও ব্যবহার:
|
|
443
|
-
*
|
|
494
|
+
* **PyPI থেকে সরাসরি ইনস্টল করতে (সবার জন্য সহজ):**
|
|
495
|
+
```bash
|
|
496
|
+
pip install auto-context-cli
|
|
497
|
+
# অথবা uv দিয়ে:
|
|
498
|
+
uv tool install auto-context-cli
|
|
499
|
+
```
|
|
500
|
+
* **উইন্ডোজ পাওয়ারশেল (1-Click Installer):**
|
|
444
501
|
```powershell
|
|
445
502
|
irm https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.ps1 | iex
|
|
446
503
|
```
|
|
447
|
-
* **লিনাক্স / WSL2
|
|
504
|
+
* **লিনাক্স / WSL2 / macOS (1-Click Installer):**
|
|
448
505
|
```bash
|
|
449
506
|
curl -sSL https://raw.githubusercontent.com/Cyber-arghya/auto-context/main/install.sh | bash
|
|
450
507
|
```
|
|
@@ -456,6 +513,10 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
|
|
|
456
513
|
ব্যস! আপনার প্রজেক্টে স্বয়ংক্রিয় কনটেক্সট ট্র্যাকিং চালু হয়ে যাবে।
|
|
457
514
|
|
|
458
515
|
### নতুন স্কিল বা রুল তৈরি করার নিয়ম:
|
|
516
|
+
> [!IMPORTANT]
|
|
517
|
+
> **এআই কোডিং এজেন্টের জন্য বাধ্যতামূলক নির্দেশিকা:**
|
|
518
|
+
> - **জিরো টোকেন অপচয় (Zero Token Waste):** কোনো রুল বা স্কিল আগে থেকে আছে কিনা তা চেক করতে ম্যানুয়ালি ফাইল খোঁজা বা পড়ার কোনো প্রয়োজন নেই। সরাসরি `init-context -r <name> [-g]` রান করুন — সিএলআই স্বয়ংক্রিয়ভাবে ডুপ্লিকেট শনাক্ত ও কলিশন গার্ড দিয়ে প্রোটেক্ট করে।
|
|
519
|
+
> - **বাধ্যতামূলক গ্লোবাল স্কোপ (Mandatory Global Scope):** ইউজার যখন "for future", "always" বা ভবিষ্যতের জন্য কোনো সাধারণ নিয়ম সেভ করতে বলবে, তখন অবশ্যই `--global` (`-g`) ব্যবহার করতে হবে এবং সাথে সাথে `init-context memory push` রান করে সেন্ট্রাল মেমরিতে সিঙ্ক করতে হবে।
|
|
459
520
|
* **নতুন রুল (Rule) তৈরি করতে:**
|
|
460
521
|
```bash
|
|
461
522
|
init-context -r my-rule-name # বর্তমান প্রজেক্টের জন্য
|
|
@@ -499,6 +560,20 @@ To prevent **Prompt Injection Leaks** and keep production secrets safe:
|
|
|
499
560
|
```
|
|
500
561
|
> **কলিশন গার্ড:** যদি একই নামের কোনো স্কিল আগে থেকেই থেকে থাকে, তবে এটি না জানিয়ে কখনো ওভাররাইট করবে না। টার্মিনালে আপনাকে ৩টি অপশন দেবে: `[O]verwrite / [R]ename / [C]ancel`।
|
|
501
562
|
|
|
563
|
+
### 🔄 মডুলার আপস্ট্রিম আপডেট ও স্বয়ংক্রিয় নোটিফিকেশন (Update & Sync):
|
|
564
|
+
অফিশিয়াল গিটহাব রিপোজিটরিতে নতুন কোনো রুলবুক, স্কিল বা এআই এজেন্ট টুল যুক্ত হলে ব্যবহারকারীরা খুব সহজে আপডেট পেতে পারেন:
|
|
565
|
+
1. **স্বয়ংক্রিয় নোটিফিকেশন ব্যানার:** চব্বিশ ঘণ্টায় একবার ব্যাকগ্রাউন্ডে চেক করে নতুন রুল আসলে টার্মিনালে সুন্দর নোটিফিকেশন দেখাবে।
|
|
566
|
+
2. **এক কমান্ডে নিরাপদ আপডেট (`init-context update`):**
|
|
567
|
+
```bash
|
|
568
|
+
init-context update # ফুল মডুলার আপডেট (CLI + গ্লোবাল প্লাগইন + সিস্টেম রুলস)
|
|
569
|
+
init-context update --check # কোনো আপডেট আছে কিনা শুধু চেক করতে
|
|
570
|
+
init-context update -w # শুধুমাত্র বর্তমান প্রজেক্টের সিস্টেম রুলস আপডেট করতে
|
|
571
|
+
```
|
|
572
|
+
> **ব্রেকিং-চেঞ্জ মুক্ত সুরক্ষা (Zero Breaking Guarantee):**
|
|
573
|
+
> * আপনার প্রজেক্টের `context.md`, `context.local.md` বা `.env` ফাইলে **কখনোই হাত দেওয়া হবে না**।
|
|
574
|
+
> * আপনার তৈরিকৃত কোনো কাস্টম রুল মুছে যাবে না।
|
|
575
|
+
> * কোনো ফাইলে কাস্টম পরিবর্তন থাকলে স্বয়ংক্রিয়ভাবে `.bak` ব্যাকআপ তৈরি হবে।
|
|
576
|
+
|
|
502
577
|
### নিরাপদ MCP টুল ম্যানেজমেন্ট (Secure Secrets via .env):
|
|
503
578
|
টোকেন বা পাসওয়ার্ড কখনোই কনফিগ ফাইলে ওপেন টেক্সটে সেভ হয় না, বরং `.env` এবং `.gitignore`-এর মাধ্যমে নিরাপদ থাকে:
|
|
504
579
|
* **টুল যুক্ত করতে (Node `npx` বা Python `uvx` সাপোর্ট):**
|
|
@@ -307,3 +307,44 @@ def new_skill(
|
|
|
307
307
|
f"[green] File: [/] {dest_file}",
|
|
308
308
|
border_style="cyan",
|
|
309
309
|
))
|
|
310
|
+
|
|
311
|
+
|
|
312
|
+
# ── promote command ───────────────────────────────────────────────────────────
|
|
313
|
+
|
|
314
|
+
def promote(
|
|
315
|
+
name: Annotated[str, typer.Argument(help="Rule or skill name to promote to Central Memory.")],
|
|
316
|
+
target: Annotated[Optional[Path], typer.Option("--target", "-t")] = None,
|
|
317
|
+
) -> None:
|
|
318
|
+
"""Promote a local workspace rule or skill to Central Memory and global scope."""
|
|
319
|
+
project_dir = (target or Path.cwd()).resolve()
|
|
320
|
+
clean_name = name.lower().replace(" ", "-").replace("_", "-").removesuffix(".md")
|
|
321
|
+
|
|
322
|
+
local_rule = project_dir / AGENTS_SUBDIR / "rules" / f"{clean_name}.md"
|
|
323
|
+
local_skill = project_dir / AGENTS_SUBDIR / "skills" / clean_name / "SKILL.md"
|
|
324
|
+
|
|
325
|
+
promoted = False
|
|
326
|
+
if local_rule.exists():
|
|
327
|
+
content = local_rule.read_text(encoding="utf-8")
|
|
328
|
+
(config.GLOBAL_PLUGIN_DIR / "rules").mkdir(parents=True, exist_ok=True)
|
|
329
|
+
(config.GLOBAL_PLUGIN_DIR / "rules" / f"{clean_name}.md").write_text(content, encoding="utf-8")
|
|
330
|
+
if config.MEMORY_DIR.exists():
|
|
331
|
+
(config.MEMORY_DIR / "rules").mkdir(parents=True, exist_ok=True)
|
|
332
|
+
(config.MEMORY_DIR / "rules" / f"{clean_name}.md").write_text(content, encoding="utf-8")
|
|
333
|
+
console.print(f"[bold green][✓] Promoted local rule '{clean_name}' to Global Plugin and Central Memory![/]")
|
|
334
|
+
promoted = True
|
|
335
|
+
|
|
336
|
+
if local_skill.exists():
|
|
337
|
+
content = local_skill.read_text(encoding="utf-8")
|
|
338
|
+
(config.GLOBAL_PLUGIN_DIR / "skills" / clean_name).mkdir(parents=True, exist_ok=True)
|
|
339
|
+
(config.GLOBAL_PLUGIN_DIR / "skills" / clean_name / "SKILL.md").write_text(content, encoding="utf-8")
|
|
340
|
+
if config.MEMORY_DIR.exists():
|
|
341
|
+
(config.MEMORY_DIR / "skills" / clean_name).mkdir(parents=True, exist_ok=True)
|
|
342
|
+
(config.MEMORY_DIR / "skills" / clean_name / "SKILL.md").write_text(content, encoding="utf-8")
|
|
343
|
+
console.print(f"[bold green][✓] Promoted local skill '{clean_name}' to Global Plugin and Central Memory![/]")
|
|
344
|
+
promoted = True
|
|
345
|
+
|
|
346
|
+
if not promoted:
|
|
347
|
+
console.print(f"[red][✗] Rule or skill '{clean_name}' not found in local workspace ({project_dir}).[/]")
|
|
348
|
+
raise typer.Exit(1)
|
|
349
|
+
|
|
350
|
+
console.print(" [cyan]💡 Run 'init-context memory push' to push changes to your private GitHub repo.[/]\n")
|