Alex Blank
44dd80cb58
- Create tool-images/ directory with organized Dockerfile templates - Add base.dockerfile with common dev tools (git, nvim, ranger, tmux, node) - Add code-server.dockerfile with VS Code in browser - Add jupyter.dockerfile with Jupyter Lab - Add opencode.dockerfile with OpenCode agent - Add pi-agent.dockerfile with Pi Coding Agent (pi.dev) - All images include: git, neovim, ranger, tmux, htop, tree, jq, Node.js 20 - Add README with usage instructions
52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
# Tool Images
|
|
|
|
This directory contains Dockerfile templates for the base tool types used in Headquarter.
|
|
|
|
## Available Images
|
|
|
|
| File | Tool | Description |
|
|
|------|------|-------------|
|
|
| `base.dockerfile` | - | Common base with git, nvim, ranger, tmux, node |
|
|
| `code-server.dockerfile` | VS Code | Browser-based VS Code with extra tools |
|
|
| `jupyter.dockerfile` | Jupyter | Jupyter Lab/Notebook with extra tools |
|
|
| `opencode.dockerfile` | OpenCode | OpenCode agent server |
|
|
| `pi-agent.dockerfile` | Pi Agent | Pi coding agent with full terminal setup |
|
|
|
|
## Usage
|
|
|
|
When creating a tool type in the Tool Workshop, you can reference these Dockerfiles:
|
|
|
|
1. Copy the contents of the desired `.dockerfile`
|
|
2. Paste into the "Dockerfile Template" field
|
|
3. Set `definition_type` to `dockerfile`
|
|
|
|
## Building Locally
|
|
|
|
To test an image locally:
|
|
|
|
```bash
|
|
cd tool-images
|
|
docker build -f pi-agent.dockerfile -t pi-agent:latest .
|
|
docker run -it pi-agent:latest
|
|
```
|
|
|
|
## Customizing
|
|
|
|
All images include:
|
|
- **git** - Version control
|
|
- **neovim** - Terminal editor
|
|
- **ranger** - Terminal file manager
|
|
- **tmux** - Terminal multiplexer
|
|
- **htop** - Process viewer
|
|
- **tree** - Directory tree
|
|
- **jq** - JSON processor
|
|
- **Node.js 20** - For npm-based tools
|
|
|
|
The `pi-agent` image additionally includes the [Pi Coding Agent](https://pi.dev/) for AI-assisted development.
|
|
|
|
## Adding New Images
|
|
|
|
1. Create a new `.dockerfile` in this directory
|
|
2. Use `base.dockerfile` as a starting point if applicable
|
|
3. Document it in the table above
|
|
4. Update the tool type in the database via the Tool Workshop |