# 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