# Bot

> Provides a local-first agent framework for observable execution, composable tool use, and multi-agent orchestration with policy-guarded execution.

- Skill: `lord1egypt/bot` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/bot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/bot/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Coding & Dev Tools, Agent Building
- Tags: Agent Framework, Botfile, Crypto Identity, Local First, Multi Agent, Policy Guarded, Thought Tree, Tui
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/lord1egypt/bot

---

# BOT: Standardized Agent Framework

bot is a local-first agent framework for observable execution, composable tool use, and multi-agent orchestration.

## Safety Model
- Network: Core demos do not initiate outbound network requests by default.
- Execution: This release provides policy-guarded local execution, not OS-level sandbox isolation.
- File System: Local memory is stored in `./.bot_memory/` by default, configurable via `BOT_MEMORY_DIR`.
- Viewer: Optional local monitor binds to `127.0.0.1` only when explicitly started.
- Credentials: No external API keys required for core demos.

## Included Capabilities
- Single-agent reasoning core
- Botfile static declaration
- TUI thought visualization
- Crypto identity and signing
- Multi-agent coordination
- Local Web thought-tree viewer
- Unified local run entrypoint
- Capability-aware tool registration
- Policy-guarded execution layer

## Quick Start
```bash
PYTHONPATH=. python3 examples/run_bot.py --mode multi --prompt "Design a safe local-first agent workflow"
```

## Custom Roles
```bash
PYTHONPATH=. python3 examples/run_bot.py --mode multi --roles "planner_bot,critic_bot,executor_bot,auditor_bot"
```

## Single-Agent Mode
```bash
PYTHONPATH=. python3 examples/run_bot.py --mode single --prompt "Summarize this task safely"
```

Then open:
- http://127.0.0.1:8765