docs: refresh stale references (repo, location, ports)
- AGENTS.md/README.md: repo -> zumayaaustin-creator/agentic-os, location -> /home/austin/agentic-os - docs/README.md, CHANGELOG.md: terminal endpoint -> /ws/terminal on main port (was dead 8082) - brain/recent-decisions.md: server port 8081 -> 8080 (settings.json is source of truth) - GRAPHIFY_MEMORY.md 8081 left as-is (graphify viz server is intentionally separate)
This commit is contained in:
Austin
parent
aa7fd2b886
commit
0347501778
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
10
README.md
10
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.
|
|||
<p>
|
||||
<a href="https://dev.to/mihir_nmodi_14a06a4019e1/i-built-an-open-source-agent-os-2h30">📖 Read the dev.to article</a>
|
||||
·
|
||||
<a href="https://github.com/modimihir07/agentic-os/issues">Report Bug</a>
|
||||
<a href="https://github.com/zumayaaustin-creator/agentic-os/issues">Report Bug</a>
|
||||
·
|
||||
<a href="https://github.com/modimihir07/agentic-os/discussions">Discussions</a>
|
||||
<a href="https://github.com/zumayaaustin-creator/agentic-os/discussions">Discussions</a>
|
||||
·
|
||||
<a href="https://github.com/modimihir07/agentic-os">GitHub</a>
|
||||
<a href="https://github.com/zumayaaustin-creator/agentic-os">GitHub</a>
|
||||
</p>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
Loading…
Reference in New Issue