Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

shell

Zsh configuration with oh-my-posh prompt, syntax highlighting, fzf-tab, zoxide, and Tangled git workflow tooling.

Options

All options under atelier.shell:

OptionTypeDefaultDescription
enableboolfalseEnable shell configuration

Tangled

Options for the tangled-setup and mkdev scripts that manage dual-remote git workflows (Tangled knot + GitHub).

OptionTypeDefaultDescription
tangled.plcIdstringATProto DID for Tangled identity
tangled.githubUserstringGitHub username
tangled.knotHoststringKnot git host (e.g. knot.dunkirk.sh)
tangled.domainstringTangled domain for repo URLs
tangled.defaultBranchstring"main"Default branch name

Included tools

  • tangled-setup — configures a repo with origin pointing to knot and github pointing to GitHub
  • mkdev — creates a new repo on both Tangled and GitHub simultaneously
  • oh-my-posh — custom prompt showing path, git status (ahead/behind), exec time, nix-shell indicator, ZMX session, SSH hostname
  • Aliasescat=bat, ls=eza, cd=z (zoxide), and more