chnjinlei/hive
1
0
Fork 0
Code Issues Pull Requests Actions 39 Packages Projects Releases Wiki Activity

feat: major file ops refactor

Browse Source
This commit is contained in:
Richard Tang
2026-05-01 07:41:42 -07:00
parent f8233bda56
commit d22a01682a
63 changed files with 631 additions and 6881 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/configuration.md
+3 -3
View File
@@ -184,9 +184,9 @@ MCP (Model Context Protocol) servers are configured in `.mcp.json` at the projec
```json
{
"mcpServers": {
"coder-tools": {
"files-tools": {
"command": "uv",
"args": ["run", "coder_tools_server.py", "--stdio"],
"args": ["run", "files_server.py", "--stdio"],
"cwd": "tools"
},
"tools": {
@@ -198,7 +198,7 @@ MCP (Model Context Protocol) servers are configured in `.mcp.json` at the projec
}
```
The `coder-tools` server provides agent scaffolding via `initialize_and_build_agent` and related tools. The `tools` MCP server exposes tools including web search, PDF reading, CSV processing, and file system operations.
The `files-tools` server exposes file I/O (`read_file`, `write_file`, `edit_file`, `hashline_edit`, `search_files`). The `tools` MCP server exposes integration tools including web search, PDF reading, CSV processing, and file system operations.
## Storage
docs/developer-guide.md
+5 -5
View File
@@ -119,7 +119,7 @@ hive/ # Repository root
│ └── README.md # Tools documentation
│
├── exports/ # AGENT PACKAGES (user-created, gitignored)
│ └── your_agent_name/ # Created via coder-tools workflow
│ └── your_agent_name/ # Created via files-tools workflow
│
├── examples/ # Example agents
│ └── templates/ # Pre-built template agents
@@ -157,7 +157,7 @@ The fastest way to build agents is with the configured MCP workflow:
./quickstart.sh
# Build a new agent
Use the coder-tools MCP tools from your IDE agent chat (e.g., initialize_and_build_agent)
Use the files-tools MCP tools from your IDE agent chat (e.g., initialize_and_build_agent)
```
### Agent Development Workflow
@@ -165,7 +165,7 @@ Use the coder-tools MCP tools from your IDE agent chat (e.g., initialize_and_bui
1. **Define Your Goal**
```
Use the coder-tools initialize_and_build_agent tool
Use the files-tools initialize_and_build_agent tool
Enter goal: "Build an agent that processes customer support tickets"
```
@@ -569,7 +569,7 @@ uv add <package>
```bash
# Option 1: Use Claude Code skill (recommended)
Use the coder-tools initialize_and_build_agent tool
Use the files-tools initialize_and_build_agent tool
# Option 2: Create manually
# Note: exports/ is initially empty (gitignored). Create your agent directory:
@@ -577,7 +577,7 @@ mkdir -p exports/my_new_agent
cd exports/my_new_agent
# Create agent.json, tools.py, README.md (see Agent Package Structure below)
# Option 3: Use the coder-tools MCP tools (advanced)
# Option 3: Use the files-tools MCP tools (advanced)
# See core/MCP_BUILDER_TOOLS_GUIDE.md
```
docs/environment-setup.md
+5 -5
View File
@@ -110,7 +110,7 @@ MCP tools are also available in Cursor. To enable:
**Claude Code:**
```
Use the coder-tools initialize_and_build_agent tool to scaffold a new agent
Use the files-tools initialize_and_build_agent tool to scaffold a new agent
```
**Codex CLI:**
@@ -261,7 +261,7 @@ hive/
│ └── pyproject.toml
│
├── exports/ # Agent packages (user-created, gitignored)
│ └── your_agent_name/ # Created via coder-tools workflow
│ └── your_agent_name/ # Created via files-tools workflow
│
└── examples/
└── templates/ # Pre-built template agents
@@ -313,9 +313,9 @@ The `.mcp.json` at project root configures MCP servers to run through `uv run` i
```json
{
"mcpServers": {
"coder-tools": {
"files-tools": {
"command": "uv",
"args": ["run", "coder_tools_server.py", "--stdio"],
"args": ["run", "files_server.py", "--stdio"],
"cwd": "tools"
},
"tools": {
@@ -353,7 +353,7 @@ This design allows agents in `exports/` to be:
### 2. Build Agent (Claude Code)
```
Use the coder-tools initialize_and_build_agent tool
Use the files-tools initialize_and_build_agent tool
Enter goal: "Build an agent that processes customer support tickets"
```
docs/getting-started.md
+4 -4
View File
@@ -65,7 +65,7 @@ This is the recommended way to create your first agent.
# Setup already done via quickstart.sh above
# Start Claude Code and build an agent
Use the coder-tools initialize_and_build_agent tool
Use the files-tools initialize_and_build_agent tool
```
Follow the interactive prompts to:
@@ -133,7 +133,7 @@ hive/
│ └── file_system_toolkits/
│
├── exports/ # Agent Packages (user-generated, not in repo)
│ └── your_agent/ # Your agents created via coder-tools workflow
│ └── your_agent/ # Your agents created via files-tools workflow
│
├── examples/
│ └── templates/ # Pre-built template agents
@@ -191,7 +191,7 @@ PYTHONPATH=exports uv run python -m my_agent test --type success
1. **Dashboard**: Run `hive open` to launch the web dashboard
2. **Detailed Setup**: See [environment-setup.md](./environment-setup.md)
3. **Developer Guide**: See [developer-guide.md](./developer-guide.md)
4. **Build Agents**: Use the coder-tools `initialize_and_build_agent` tool in Claude Code
4. **Build Agents**: Use the files-tools `initialize_and_build_agent` tool in Claude Code
5. **Custom Tools**: Learn to integrate MCP servers
6. **Join Community**: [Discord](https://discord.com/invite/MXE49hrKDk)
@@ -236,4 +236,4 @@ pip uninstall -y framework tools
- **Documentation**: Check the `/docs` folder
- **Issues**: [github.com/adenhq/hive/issues](https://github.com/aden-hive/hive/issues)
- **Discord**: [discord.com/invite/MXE49hrKDk](https://discord.com/invite/MXE49hrKDk)
- **Build Agents**: Use the coder-tools workflow to create agents
- **Build Agents**: Use the files-tools workflow to create agents
docs/roadmap.md
+1 -3
View File
@@ -369,7 +369,6 @@ Port popular tools, and build out the Runtime Log, Audit Trail, Excel, and Email
- [x] Subdomain Enumerator (tools/subdomain_enumerator/)
- [x] Tech Stack Detector (tools/tech_stack_detector/)
- [x] **Runtime & Logging**
- [x] Runtime Log Tool (tools/runtime_logs_tool/)
- [x] Runtime Logger with L1/L2/L3 levels (runtime/runtime_logger.py)
- [ ] **Audit Trail System**
- [ ] Decision tracing beyond logs
@@ -802,8 +801,7 @@ Port the existing Terminal User Interface (TUI) into a rich web application, all
### Memory & State Inspector
Create a UI component to inspect the Shared Memory and Write-Through Conversation Memory, allowing developers to click on any node and see exactly what it is thinking.
- [x] **Runtime Logs Tool**
- [x] Inspect agent session logs (tools/runtime_logs_tool/)
- [x] **Session State**
- [x] Session state retrieval (builder/package_generator.py)
- [ ] **Memory Inspector UI**
- [ ] Shared Memory visualization