dotfiles/README.md
mwiegand 8d5406b7ef
add Claude Code statusline script
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-12 22:59:51 +02:00

66 lines
1.7 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`)
- `claude/statusline-command.sh` — Claude Code statusline (dir, branch, model, thinking, rate limits)
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
ln -s "$HOME/Projekte/dotfiles/claude/statusline-command.sh" ~/.claude/statusline-command.sh
```
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