home / skills / trentshaines / dotfiles / trent-config

trent-config skill

safe

This skill provides an overview of Trent's fish-based development environment, guiding you through primary tools, dotfile workflow, and VI-keybindings.

npx playbooks add skill trentshaines/dotfiles --skill trent-config

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

3.4 KB

---
name: trent-config
description: Overview of Trent's development environment and dotfiles setup. Use this skill first to understand the overall setup, then reference specific skills for details. CRITICAL - Trent uses fish shell, NOT zsh.
---

# Trent's Development Environment

## Quick Reference

| Tool | Purpose | Skill | Config Location |
|------|---------|-------|-----------------|
| **fish** | Shell (PRIMARY) | `trent-fish` | `~/.config/fish/config.fish` |
| **chezmoi** | Dotfile management | `trent-chezmoi` | `~/.local/share/chezmoi/` |
| **tmux** | Terminal multiplexer | `trent-tmux` | `~/.tmux.conf` |
| **sesh** | Tmux session switcher | `trent-tmux` | - |
| **tmuxinator** | Tmux session templates | `trent-tmux` | `~/.config/tmuxinator/*.yml` |
| **lazyvim** | Neovim distribution | `trent-lazyvim` | `~/.config/nvim/` |
| **aerospace** | Window manager | `trent-aerospace` | `~/.config/aerospace/aerospace.toml` |
| **obsidian** | Notes/Zettelkasten | `trent-obsidian` | `~/Documents/obsidian-vault/` |
| **starship** | Prompt | - | `~/.config/starship.toml` |

## Critical Facts

1. **Fish is the primary shell** - Always add aliases/functions to fish, never zsh
2. **Chezmoi manages dotfiles** - After editing configs, sync with `chezmoi add` or `cadd`
3. **Tmux uses 1-based indexing** - Panes and windows start at 1, not 0
4. **Vi mode everywhere** - Fish, tmux, and nvim all use vi keybindings

## Machines

| Name | Address | Access |
|------|---------|--------|
| Mac Mini | `100.77.152.106` | `mm` alias (SSH + port forward 3000, 8000) |

## Common Paths

```
~/.config/fish/           # Fish shell config
~/.config/nvim/           # Neovim/LazyVim config
~/.config/tmuxinator/     # Tmux session templates
~/.config/aerospace/      # Window manager config
~/.local/share/chezmoi/   # Chezmoi source (dotfiles repo)
~/.claude/skills/         # Claude Code skills
~/git/                    # Git projects
```

## Chezmoi Workflow

After editing any config file:
```fish
cadd                      # Re-add changed files to chezmoi
# or
chezmoi add ~/.config/... # Add specific file
```

Then commit in `~/.local/share/chezmoi/`.

## Key Aliases

```fish
# Config editing
ef                        # Edit fish config
v                         # Neovim

# Chezmoi
cadd                      # chezmoi re-add
capply                    # chezmoi apply

# Tmux
ts                        # Session switcher (fzf)
tnw                       # New window with 3-pane layout

# SSH
mm                        # SSH to Mac Mini with port forwards
```

## Tmuxinator Sessions

- `config` - Dotfiles editing (root: ~/.config)
- `admin` - System monitoring (btop + terminals)
- `default` - Template for project sessions

## When Editing Configs

1. Use the appropriate skill for detailed help (trent-fish, trent-tmux, trent-lazyvim, etc.)
2. Remember to sync to chezmoi after changes
3. Fish syntax differs from bash/zsh:
   - `set -gx VAR value` not `export VAR=value`
   - `(command)` not `$(command)`
   - Functions go in `~/.config/fish/functions/name.fish`

## Skills Index

- **trent-fish** - Shell config, aliases, functions, vi mode
- **trent-tmux** - Sessions, tmuxinator templates, sesh, window layouts
- **trent-chezmoi** - Dotfile management, syncing, ansible playbooks
- **trent-lazyvim** - Neovim config, plugins, LSP, keybindings
- **trent-aerospace** - Window management, workspaces, tiling
- **trent-obsidian** - Zettelkasten notes, vault search
- **trent-claude-skills** - Creating and managing skills

Overview

This skill provides a concise overview of Trent's development environment and dotfiles setup. Use it first to orient yourself to the global layout, key conventions, and where to find detailed skills for each tool. Note: Trent uses fish as the primary shell — do not add configs to zsh.

How this skill works

The skill maps tools to their purpose, main config locations, and the dedicated follow-up skills to consult for details. It highlights critical facts and a small workflow for editing and syncing dotfiles with chezmoi. Use the listed aliases, common paths, and tmuxinator sessions to quickly navigate and operate the environment.

When to use it

On first access to Trent's machine or dotfiles to get oriented
Before editing any config so you follow the correct workflow and file locations
When adding aliases or functions to ensure changes go to fish, not zsh
When preparing commits to chezmoi after config changes
When launching or restoring tmux/tmuxinator sessions
When you need the right follow-up skill for deep edits (fish, tmux, lazyvim, etc.)

Best practices

Always add shell aliases/functions to fish (~/.config/fish/). Never use zsh for primary configs.
After changing any config, re-add with chezmoi (cadd or chezmoi add) and commit in ~/.local/share/chezmoi/.
Remember tmux uses 1-based indexing for panes and windows — scripts or mental math assuming 0-based will break.
Keep vi-mode consistency: fish, tmux, and nvim use vi keybindings; edit with that in mind.
Place functions in ~/.config/fish/functions/name.fish and use fish syntax (set -gx VAR value, (command)).

Example use cases

Open ef to edit fish config, then run cadd and commit to chezmoi.
Start a project session with tmuxinator default and use ts to switch sessions.
Edit Neovim settings in ~/.config/nvim/ and consult trent-lazyvim for plugin or LSP questions.
SSH to the Mac Mini using mm (includes port forwards for local dev servers).
Create or update a chezmoi-managed dotfile and reapply it across machines with capply.

FAQ

What shell should I modify for aliases and functions?

Modify fish (~/.config/fish/). Trent uses fish as the primary shell; do not add changes to zsh.

How do I persist config edits across machines?

After editing, run cadd or chezmoi add to re-add files to chezmoi, commit in ~/.local/share/chezmoi/, then apply on target machines with chezmoi apply (capply).