dotfiles/README.md
mwiegand d97d9912b4
feat(agents): split global agent config into shared base + per-agent wrappers
- agents/AGENTS.md: shared, agent-agnostic personal preferences
- agents/AGENTS-claude.md: Claude Code wrapper (@AGENTS.md + @RTK.md)
- agents/AGENTS-opencode.md: OpenCode wrapper (@AGENTS.md)
- Old claude/CLAUDE.md removed; symlinks updated in ~/.claude and ~/.config/opencode

This lets each agent layer in tool-specific content (e.g. the Agent tool
tiering for Claude Code, RTK hooks) without leaking it into other agents.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 22:56:14 +02:00

64 lines
1.5 KiB
Markdown

# dotfiles
Shared shell and tool configuration.
## Scope
Tracked files:
- `.zshrc` — shared zsh UI behavior
- `agents/AGENTS.md` — shared global personal preferences (agent-agnostic)
- `agents/AGENTS-claude.md` — Claude Code wrapper (`@AGENTS.md` + `@~/.claude/RTK.md`)
- `agents/AGENTS-opencode.md` — OpenCode wrapper (`@AGENTS.md`)
This repo is intentionally small. Machine-specific setup stays local unless explicitly promoted into shared config later.
## Local Setup
**zsh**: Local `~/.zshrc` sources this repo:
```zsh
source "$HOME/Projekte/dotfiles/.zshrc"
```
**Claude Code & OpenCode**: symlink the wrappers into each agent's config dir:
```zsh
ln -s "$HOME/Projekte/dotfiles/agents/AGENTS-claude.md" ~/.claude/CLAUDE.md
ln -s "$HOME/Projekte/dotfiles/agents/AGENTS-opencode.md" ~/.config/opencode/AGENTS.md
```
The wrappers `@`-include the shared base `agents/AGENTS.md`; add agent-specific content directly in the wrapper file.
## What Lives Here
Current shared config includes:
- prompt styling
- git branch display in the prompt
- exit-code based prompt arrow color
- zsh autosuggestions
- prefix-based history search on arrow keys
## Verification
Syntax check:
```bash
zsh -n ~/.zshrc
zsh -n ~/Projekte/dotfiles/.zshrc
```
Quick interactive prompt check:
```bash
zsh -i -c 'true; precmd; print -P -- "$PROMPT"'
```
## Notes
Keep this repo focused on shared interactive shell UX.
Examples of config that should usually stay local:
- secrets
- host-specific paths
- machine-specific SDK setup
- one-off helper functions