dotfiles/README.md

40 lines
1.2 KiB
Markdown

# dotfiles
Personal dotfiles and AI-agent infrastructure for VS Code Copilot and OpenCode.
## Quick Start
For host machines, install dotfiles plus llama-server config and systemd services via the `--host` flag:
```bash
git clone https://github.com/username/dotfiles ~/dotfiles
~/dotfiles/install.sh --host
```
If using devcontainers, drop the `--host` flag in the Dockerfile or just rely on vscode settings or, possibly better, a devcontainer "features" config such as:
```json
"features": {
"ghcr.io/willfantom/features/dotfiles:1": {
"repository": "git@git.bcdewitt.ddns.net:bcdewitt/dotfiles.git",
"targetPath": "~/dotfiles",
"installCommand": "install.sh"
}
}
```
## What Gets Installed
**Basic install** (`install.sh`):
- Agent hooks wired into VS Code Copilot and OpenCode (the `.agents/` infrastructure)
- OpenCode config symlinked to `~/.config/opencode/opencode.json`
**Host install** (`install.sh --host`):
- Everything in basic install, plus:
- llama-server presets, startup script, and systemd units from `.agents/llama-server/`
## Idempotent
The install script is idempotent — safe to re-run at any time. It skips steps that
are already in place and only changes what needs updating.