bardgent 1.0.0__tar.gz

bardgent-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bardia Emamgholizadeh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bardgent-1.0.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: bardgent
+Version: 1.0.0
+Summary: A command-line coding agent (OpenAI-compatible API; default NVIDIA Nemotron)
+Author-email: Bardia Emamgholizadeh <bardia.egzz@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bardiaegz/BardGent
+Project-URL: Repository, https://github.com/bardiaegz/BardGent
+Project-URL: Issues, https://github.com/bardiaegz/BardGent/issues
+Keywords: cli,agent,coding-agent,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai
+Requires-Dist: requests
+Requires-Dist: beautifulsoup4
+Requires-Dist: rich
+Requires-Dist: prompt-toolkit
+Requires-Dist: python-dotenv
+Dynamic: license-file
+
+# Bardgent
+
+A terminal coding agent with tools for files, shell, web, memory, skills, sub-agents, and scheduled tasks.
+
+## Setup
+
+```bash
+python -m venv venv
+source venv/bin/activate
+pip install -e .
+```
+
+Set an API key (env name is historical; any OpenAI-compatible key works with the configured base URL):
+
+```bash
+# ~/.bardgent/.env  or export in your shell
+GEMINI_API_KEY=your_key_here
+```
+
+Then run:
+
+```bash
+bardgent
+```
+
+## Defaults
+
+| Setting | Value |
+|---------|--------|
+| API base | `https://integrate.api.nvidia.com/v1` |
+| Model | `nvidia/nemotron-3-ultra-550b-a55b` |
+| Config dir | `~/.bardgent/` |
+
+## Modes
+
+| Mode | Behavior |
+|------|----------|
+| **normal** | Approve Write/Edit/Bash (and similar) per action |
+| **auto** | Auto-approve non-dangerous actions; dangerous shell still prompts |
+| **plan** | Read-only tools only; agent proposes a plan, then you choose how to execute |
+
+Cycle with **Shift+Tab** or `/normal`, `/auto`, `/plan`.
+
+## Tools (high level)
+
+- **Files:** Read, Write, Edit, Undo, Glob, Grep  
+- **Shell:** Bash (cwd persists), background jobs via `ListJobs` / `Await`  
+- **Web:** WebSearch (DuckDuckGo), Fetch  
+- **Memory:** save / list / delete long-term notes (`~/.bardgent/Bardgent.md`)  
+- **Skills:** Claude Code–style `SKILL.md` packs; `/skills`, `/skill install <github_url>`  
+- **Delegation:** `Task` / `Tasks` (parallel sub-agents)  
+- **Schedule:** recurring or one-off tasks; `/schedule`, `/schedules`. A detached **scheduler daemon** keeps firing tasks after you close the terminal (auto-started with Bardgent). Manage with `/schedule daemon status|start|stop`. Log: `~/.bardgent/scheduler.log`.
+
+## Project instructions
+
+Place any of these in the project root (all that exist are loaded):
+
+- `AGENTS.md`
+- `.bardgent/AGENTS.md`, `.bardgent/instructions.md`, `.bardgent/RULES.md`
+
+## Skills locations
+
+1. `./.bardgent/skills/<name>/SKILL.md` (project)
+2. `~/.bardgent/skills/<name>/SKILL.md` (user)
+3. Package `skills/` (optional bundled defaults)
+
+## Permissions
+
+Per-project file: `.bardgent/permissions.json`
+
+```json
+{
+  "auto_approve_bash_prefixes": ["git status", "pytest"],
+  "auto_approve_tools": ["Fetch", "Write", "Edit"],
+  "extra_dangerous_patterns": []
+}
+```
+
+## Useful commands
+
+Type `/help` in the REPL for the full list. Highlights: `/resume`, `/checkpoints`, `/restore`, `/telegram`, `/summary`, `/clear`.
+
+## License
+
+Use and modify as you like for personal / project use.

bardgent-1.0.0/README.md

@@ -0,0 +1,85 @@
+# Bardgent
+
+A terminal coding agent with tools for files, shell, web, memory, skills, sub-agents, and scheduled tasks.
+
+## Setup
+
+```bash
+python -m venv venv
+source venv/bin/activate
+pip install -e .
+```
+
+Set an API key (env name is historical; any OpenAI-compatible key works with the configured base URL):
+
+```bash
+# ~/.bardgent/.env  or export in your shell
+GEMINI_API_KEY=your_key_here
+```
+
+Then run:
+
+```bash
+bardgent
+```
+
+## Defaults
+
+| Setting | Value |
+|---------|--------|
+| API base | `https://integrate.api.nvidia.com/v1` |
+| Model | `nvidia/nemotron-3-ultra-550b-a55b` |
+| Config dir | `~/.bardgent/` |
+
+## Modes
+
+| Mode | Behavior |
+|------|----------|
+| **normal** | Approve Write/Edit/Bash (and similar) per action |
+| **auto** | Auto-approve non-dangerous actions; dangerous shell still prompts |
+| **plan** | Read-only tools only; agent proposes a plan, then you choose how to execute |
+
+Cycle with **Shift+Tab** or `/normal`, `/auto`, `/plan`.
+
+## Tools (high level)
+
+- **Files:** Read, Write, Edit, Undo, Glob, Grep  
+- **Shell:** Bash (cwd persists), background jobs via `ListJobs` / `Await`  
+- **Web:** WebSearch (DuckDuckGo), Fetch  
+- **Memory:** save / list / delete long-term notes (`~/.bardgent/Bardgent.md`)  
+- **Skills:** Claude Code–style `SKILL.md` packs; `/skills`, `/skill install <github_url>`  
+- **Delegation:** `Task` / `Tasks` (parallel sub-agents)  
+- **Schedule:** recurring or one-off tasks; `/schedule`, `/schedules`. A detached **scheduler daemon** keeps firing tasks after you close the terminal (auto-started with Bardgent). Manage with `/schedule daemon status|start|stop`. Log: `~/.bardgent/scheduler.log`.
+
+## Project instructions
+
+Place any of these in the project root (all that exist are loaded):
+
+- `AGENTS.md`
+- `.bardgent/AGENTS.md`, `.bardgent/instructions.md`, `.bardgent/RULES.md`
+
+## Skills locations
+
+1. `./.bardgent/skills/<name>/SKILL.md` (project)
+2. `~/.bardgent/skills/<name>/SKILL.md` (user)
+3. Package `skills/` (optional bundled defaults)
+
+## Permissions
+
+Per-project file: `.bardgent/permissions.json`
+
+```json
+{
+  "auto_approve_bash_prefixes": ["git status", "pytest"],
+  "auto_approve_tools": ["Fetch", "Write", "Edit"],
+  "extra_dangerous_patterns": []
+}
+```
+
+## Useful commands
+
+Type `/help` in the REPL for the full list. Highlights: `/resume`, `/checkpoints`, `/restore`, `/telegram`, `/summary`, `/clear`.
+
+## License
+
+Use and modify as you like for personal / project use.

bardgent-1.0.0/bardgent/__init__.py

@@ -0,0 +1,3 @@
+"""BardGent - a small terminal coding agent."""
+
+__version__ = "1.0.0"

bardgent-1.0.0/bardgent/__main__.py

@@ -0,0 +1,5 @@
+"""Allow `python -m bardgent` (and the scheduler daemon spawn) to work."""
+from bardgent.main import main
+
+if __name__ == '__main__':
+    main()

bardgent-1.0.0/bardgent/checkpoints.py

@@ -0,0 +1,132 @@
+"""
+Silent, git-backed project checkpoints. Every applied Write/Edit inside a
+git repo gets snapshotted onto a side ref (refs/bardgent/checkpoints) via a
+throwaway index file, so it never touches the user's real HEAD, branch, or
+staged changes. /checkpoints lists them, /restore <n> rolls the working
+tree back to one.
+"""
+
+import os
+import json
+import time
+import subprocess
+
+from bardgent import config
+from bardgent.config import log_event
+
+
+def _git_root(path):
+    try:
+        result = subprocess.run(
+            ['git', 'rev-parse', '--show-toplevel'],
+            cwd=os.path.dirname(os.path.abspath(path)) or '.',
+            capture_output=True, text=True, timeout=5,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except (OSError, subprocess.SubprocessError):
+        pass
+    return None
+
+
+def _load_checkpoint_log():
+    if config.CHECKPOINT_LOG.exists():
+        try:
+            return json.loads(config.CHECKPOINT_LOG.read_text(encoding='utf-8'))
+        except (OSError, json.JSONDecodeError):
+            return []
+    return []
+
+
+def _save_checkpoint_log(entries):
+    try:
+        config.PERMISSIONS_DIR.mkdir(exist_ok=True)
+        config.CHECKPOINT_LOG.write_text(json.dumps(entries, indent=2), encoding='utf-8')
+    except OSError as e:
+        log_event(f"CHECKPOINT LOG SAVE FAILED: {e}")
+
+
+def make_git_checkpoint(path, message):
+    root = _git_root(path)
+    if not root:
+        return None
+    try:
+        env = os.environ.copy()
+        env['GIT_INDEX_FILE'] = str(config.CHECKPOINT_INDEX_FILE)
+        subprocess.run(['git', 'add', '-A'], cwd=root, env=env, capture_output=True, text=True, timeout=20)
+        tree = subprocess.run(['git', 'write-tree'], cwd=root, env=env, capture_output=True, text=True, timeout=20)
+        if tree.returncode != 0:
+            log_event(f"CHECKPOINT write-tree failed: {tree.stderr.strip()}")
+            return None
+        tree_hash = tree.stdout.strip()
+
+        parent_args = []
+        parent = subprocess.run(['git', 'rev-parse', config.CHECKPOINT_REF], cwd=root, capture_output=True, text=True, timeout=5)
+        if parent.returncode == 0:
+            parent_args = ['-p', parent.stdout.strip()]
+        else:
+            head = subprocess.run(['git', 'rev-parse', 'HEAD'], cwd=root, capture_output=True, text=True, timeout=5)
+            if head.returncode == 0:
+                parent_args = ['-p', head.stdout.strip()]
+
+        commit = subprocess.run(
+            ['git', 'commit-tree', tree_hash, *parent_args, '-m', message],
+            cwd=root, env=env, capture_output=True, text=True, timeout=20,
+        )
+        if commit.returncode != 0:
+            log_event(f"CHECKPOINT commit-tree failed: {commit.stderr.strip()}")
+            return None
+        commit_hash = commit.stdout.strip()
+
+        upd = subprocess.run(['git', 'update-ref', config.CHECKPOINT_REF, commit_hash], cwd=root, capture_output=True, text=True, timeout=10)
+        if upd.returncode != 0:
+            log_event(f"CHECKPOINT update-ref failed: {upd.stderr.strip()}")
+            return None
+
+        entries = _load_checkpoint_log()
+        entries.append({
+            'time': time.strftime('%Y-%m-%d %H:%M:%S'),
+            'message': message,
+            'commit': commit_hash,
+            'root': root,
+        })
+        entries = entries[-100:]
+        _save_checkpoint_log(entries)
+        log_event(f"CHECKPOINT {commit_hash[:10]} ({message})")
+        return commit_hash
+    except (OSError, subprocess.SubprocessError) as e:
+        log_event(f"CHECKPOINT failed: {type(e).__name__}: {e}")
+        return None
+
+
+def list_checkpoints():
+    entries = _load_checkpoint_log()
+    if not entries:
+        return '(no checkpoints yet. checkpoints are created automatically on Write/Edit inside a git repo)'
+    lines = []
+    for i, e in enumerate(entries, 1):
+        lines.append(f"{i}. {e['time']}  {e['commit'][:10]}  {e['message']}")
+    return '\n'.join(lines)
+
+
+def restore_checkpoint(index):
+    entries = _load_checkpoint_log()
+    try:
+        idx = int(index)
+    except (TypeError, ValueError):
+        return f"Invalid checkpoint index: {index!r}"
+    if idx < 1 or idx > len(entries):
+        return f"No checkpoint at index {idx}. Use /checkpoints to see valid indices."
+    entry = entries[idx - 1]
+    root, commit = entry['root'], entry['commit']
+    try:
+        result = subprocess.run(
+            ['git', 'checkout', commit, '--', '.'],
+            cwd=root, capture_output=True, text=True, timeout=30,
+        )
+        if result.returncode != 0:
+            return f"Restore failed: {result.stderr.strip()}"
+    except (OSError, subprocess.SubprocessError) as e:
+        return f"Restore failed: {type(e).__name__}: {e}"
+    log_event(f"RESTORED checkpoint #{idx} ({commit[:10]})")
+    return f"Working tree in {root} restored to checkpoint #{idx} ({entry['time']}, {commit[:10]}). Your git branch/HEAD/index are untouched. only file contents were overwritten."