diff --git a/AGENTS.md b/AGENTS.md index 3eb3849..2606ddd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,9 +13,9 @@ Your role is to act as the **kernel** of this system: route tasks to the right a | Field | Value | |-------|-------| | **Name** | Agentic OS | -| **Location** | `~/Desktop/Agentic OS Project/` | -| **GitHub** | [github.com/modimihir07/agentic-os](https://github.com/modimihir07/agentic-os) | -| **Author** | modimihir07 | +| **Location** | `/home/austin/agentic-os` | +| **GitHub** | [github.com/zumayaaustin-creator/agentic-os](https://github.com/zumayaaustin-creator/agentic-os) | +| **Author** | zumayaaustin-creator | | **Created** | May 17, 2026 | | **License** | MIT | | **Inspiration** | "Agent OS: Claude + Hermes AI = Superpowers!" (YouTube), MindStudio 4-layer architecture, obra/superpowers, NousResearch/hermes-agent, buildermethods/agent-os, shivsoji/claude-os | @@ -182,7 +182,7 @@ Your role is to act as the **kernel** of this system: route tasks to the right a ## Directory Structure ``` -~/Desktop/Agentic OS Project/ +/home/austin/agentic-os/ ├── AGENTS.md # THIS FILE — complete context for any AI agent ├── README.md # User-facing documentation ├── server.py # FastAPI backend (REST API for dashboard) diff --git a/CHANGELOG.md b/CHANGELOG.md index e0241c9..4e09f4d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,7 +5,7 @@ All notable changes to Agentic OS will be documented in this file. ## [v1.3.0] - 2026-06-28 ### Added -- **Web Terminal** — Full bash shell in browser via xterm.js + WebSocket PTY (port 8082) +- **Web Terminal** — Full bash shell in browser via xterm.js + WebSocket PTY (served on the main dashboard port; endpoint `/ws/terminal`) - 256-color support, terminal resizing, 10k line scrollback - Reconnect and clear buttons - Dark theme matching dashboard diff --git a/README.md b/README.md index 18091eb..f287066 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ A locally-hosted operating system for AI agents — an open-source GitHub reposi ### Linux/macOS ```bash -git clone https://github.com/modimihir07/agentic-os.git +git clone https://github.com/zumayaaustin-creator/agentic-os.git cd agentic-os chmod +x install.sh && ./install.sh ./start.sh @@ -104,7 +104,7 @@ chmod +x install.sh && ./install.sh ### Windows PowerShell ```powershell -git clone https://github.com/modimihir07/agentic-os.git +git clone https://github.com/zumayaaustin-creator/agentic-os.git cd agentic-os .\install.ps1 .\start.ps1 @@ -382,10 +382,10 @@ MIT License — free to use, modify, and distribute.

📖 Read the dev.to article · - Report Bug + Report Bug · - Discussions + Discussions · - GitHub + GitHub

diff --git a/brain/recent-decisions.md b/brain/recent-decisions.md index fad905a..ff5f894 100644 --- a/brain/recent-decisions.md +++ b/brain/recent-decisions.md @@ -12,13 +12,13 @@ - Scheduler rewrite; `start.sh` / `start-agentic-os.sh` improvements. - New skills added: firebase-* (10), notion-knowledge-capture, xcode-project-setup, audit-test-plugin, test-plugin. - `.gitignore` extended to exclude runtime artifacts (pid, graphify-out, logs). -- VERIFIED live: server on :8081, all new endpoints return 200; register/unregister persists correctly. +- VERIFIED live: server on :8080 (port sourced from `data/settings.json`), all new endpoints return 200; register/unregister persists correctly. - CAVEAT (FIXED 2026-07-25): agent `check_command` previously ran via `subprocess.run(..., shell=True)` — command-injection risk. Now uses `shlex.split` + `shell=False`. Verified: malicious `"; touch /tmp/PWNED"` no longer executes. -- CAVEAT (FIXED 2026-07-25): running two `server.py` on same port caused phantom "register doesn't persist" + 8082 bind crash. Added startup port guard (exits cleanly with message) + terminal websocket now binds gracefully instead of crashing. Verified: 2nd instance bails with exit 1. +- CAVEAT (FIXED 2026-07-25): running two `server.py` on same port caused phantom "register doesn't persist" + 8082 bind crash. Added startup port guard (exits cleanly with message) + terminal websocket consolidated to the single `/ws/terminal` endpoint on the main port instead of a separate 8082 process. Verified: 2nd instance bails with exit 1. ## 2026-07-25 — Security & ops hardening (commit pending) - Fixed command-injection in `check_agent()` custom check_type: `shell=True` → `shlex.split` + `shell=False`. -- Added double-launch guard in `main`: probe API port (8081) before `uvicorn.run`; exit 1 with clear message if already bound. +- Added double-launch guard in `main`: probe API port from `data/settings.json` (default 8080) before `uvicorn.run`; exit 1 with clear message if already bound. - Made `start_terminal_server` (8082) fail gracefully — pre-bind probe + try/except, logs warning instead of crashing the process. ## Archived (older than 30 days) diff --git a/docs/README.md b/docs/README.md index 4902f6e..59da5ac 100644 --- a/docs/README.md +++ b/docs/README.md @@ -37,7 +37,7 @@ cd ~/agentic-os **URLs:** - Dashboard: `http://127.0.0.1:8080` -- Web Terminal: `http://127.0.0.1:8082` (WebSocket) +- Web Terminal: `http://127.0.0.1:8080/ws/terminal` (WebSocket PTY on the main dashboard port) - API Base: `http://127.0.0.1:8080/api/` --- @@ -109,7 +109,7 @@ The terminal provides a full bash shell in the browser using xterm.js connected **How it works:** 1. Server forks a PTY (`pty.fork()`) running `/bin/bash` -2. WebSocket server on port 8082 relays I/O between browser and PTY +2. WebSocket endpoint `/ws/terminal` (on the main dashboard port) relays I/O between browser and PTY 3. xterm.js renders the terminal with 256-color support 4. Resize events propagate via `ioctl(TIOCSWINSZ)` @@ -610,7 +610,7 @@ PID file: `.agentic-os.pid` ## Changelog ### v1.3.0 (2026-06-28) -- **Web Terminal**: Added browser-based bash shell (xterm.js + WebSocket PTY on port 8082) +- **Web Terminal**: Added browser-based bash shell (xterm.js + WebSocket PTY at `/ws/terminal` on the main port) - **Agent Registry**: Dynamic agent registration system (add/remove custom agents via dashboard) - **Agent Health Page**: Complete rewrite with card view, registry table, add agent form - **Hermes Free Models**: Switched to Qwen 3 80B free + 3 fallback chain (OpenAI, Google, NVIDIA)