Your preferences, written once. Useful everywhere.

Describe what you prefer in plain Markdown.
Let your AI agents do the complicated stuff.

Create preferences

How it works

01 / Write

Capture your preferences in one place on prefs.io.

02 / Share

Share preferences with your AI agent—or with the world via secret or public URL.

03 / Apply

Your AI agent applies the preferences to the applicable context.

One format, many outcomes

https://prefs.io/examples/terminal

# Terminal setup

- Tooling: bash, tmux, starship, Git, and fzf with shell integration
- Font: NotoMono Nerd Font Mono
- Font size: 12 pt
- Colors: Dracula
- tmux prefix: Ctrl-A
- Use vi keys in tmux
- Use a compact one-line prompt that shows my current directory, Git branch, and current time in h:mm format
- Additional path entries: ~/.npm/bin, ~/.local/bin

## Reference Prompts

### `apply-terminal`

Apply these preferences to this machine. Preserve unrelated settings, install missing dependencies only when needed, and verify the result.

### `audit-terminal`

Compare this machine's terminal configuration with my preferences. Report differences without changing anything.

kitty.conf

font_family NotoMono Nerd Font Mono
font_size 12.0
foreground #f8f8f2
background #282a36
cursor #f8f8f2
selection_background #44475a
color1 #ff5555
color2 #50fa7b
color3 #f1fa8c
color4 #bd93f9
color5 #ff79c6
color6 #8be9fd

tmux.conf

unbind C-b
set -g prefix C-a
bind C-a send-prefix
setw -g mode-keys vi
set -g status-keys vi

starship.toml

add_newline = false
format = "$directory$git_branch$time$character"

[directory]
truncation_length = 3

[git_branch]
format = "[$symbol$branch]($style) "

[time]
disabled = false
time_format = "%-H:%M"

.bashrc

export PATH="$HOME/.npm/bin:$HOME/.local/bin:$PATH"

if command -v fzf >/dev/null 2>&1; then
  eval "$(fzf --bash)"
fi

https://prefs.io/your-handle/ai.md

# How I work with AI

- Lead with the outcome.
- Keep routine answers concise.
- Explain material tradeoffs before acting.
- Preserve unrelated code and configuration.
- Ask before destructive or irreversible actions.
- Verify code changes with focused tests.

## Prompts

### `configure-ai-tools`

Apply the relevant preferences to the AI assistant instruction files in this workspace. Preserve project-specific rules and show proposed changes before replacing existing instructions.

### `review-agent-instructions`

Compare the current agent instructions with my preferences. Report conflicts and omissions without changing any files.

AGENTS.md

# Agent preferences

- Lead with the outcome.
- Preserve unrelated changes.
- Ask before destructive actions.
- Run focused tests.

CLAUDE.md

## Working style

Keep routine answers concise.
Explain material tradeoffs before acting.
Never replace project-specific rules.

.github/copilot-instructions.md

Prefer focused changes.
Preserve unrelated code and configuration.
Verify each change with the narrowest useful test.

custom-instructions.md

Lead with the result.
State important tradeoffs.
Confirm destructive or irreversible actions first.

https://prefs.io/your-handle/brand-voice.md

# Brand voice

- Direct, calm, and specific.
- Prefer short sentences and concrete verbs.
- Confident without hype.
- No exclamation marks or empty superlatives.
- Explain technical ideas in plain language.

## Prompts

### `rewrite-draft`

Rewrite the draft in this conversation using my brand voice. Preserve its factual meaning and flag conflicts with the requested audience or channel.

### `review-copy`

Review the supplied copy against my brand voice. Return a concise list of specific improvements without rewriting it.

Product announcement

Your preferences now travel with you.

Write them once in Markdown. Share a link with any agent that needs them.

Customer email

We simplified preference sharing.

Your existing link still works. The page is clearer and faster to inspect.

Social post

Stop repeating the same preferences to every tool.

Keep one readable source. Let agents adapt it.

Interface copy

Create link

Anyone with this secret link can read these preferences.

https://prefs.io/your-handle/music.md

# Music preferences

## By time of day

- Morning: Coffee Lounge and chilled instrumental music
- Evening: jazz, warm vocals, and small ensembles

## Favorites

- Genres: jazz, neo-soul, downtempo, lo-fi hip-hop
- Artists: Miles Davis, Norah Jones, Khruangbin, Nujabes

## Recent playlists

- Coffee Table Jazz
- Chillhop Essentials
- Late Night Jazz

## Prompts

### `fresh-random-playlist`

Generate a fresh, shuffled playlist based on my favorite artists. Avoid tracks played recently.

### `play-on-echo-livingroom`

Play music through Spotify on my Echo Livingroom device. Choose music appropriate for the current time of day.

Your playlist

Morning Coffee & Jazz

01. Khruangbin — Friday Morning
02. Norah Jones — Sunrise
03. Nujabes — Aruarian Dance
04. Miles Davis — Blue in Green

Matched preferences

Time: Morning
Mood: Coffee Lounge / chill
Genres: jazz, downtempo
Based on: favorites + recent playlists

Up next

05. BADBADNOTGOOD — Time Moves Slow
06. Bill Evans — Peace Piece
07. Tom Misch — Movie
08. Chet Baker — I Fall in Love Too Easily

Now playing

▶ Khruangbin — Friday Morning

Playlist: Morning Coffee & Jazz
Service: Spotify
Device: Echo Livingroom
Playback: Started

Use the Terminal setup example with your AI agent

Use this sample prompt with your AI agent:

Fetch https://prefs.io/examples/terminal.md and execute the prompt `apply-terminal`.

Always inspect preferences before passing their URL to your AI agent.