A terminal-centric development workspace configuration that uses mise to bootstrap and manage tools for agent-driven development, with support for multiple AI coding agents and safe overlaying onto existing OS configurations.

Stars

36

7-day growth

No data

Forks

1

Open issues

0

License

No data

Last updated

2026-07-22

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a disciplined, config-only approach to managing an agent-driven development environment, leveraging mise for deterministic setup and supporting multiple AI agent frameworks (omp and pi) with careful separation of secrets and runtime state.

Who it is for

  • Developers using AI coding agents (Claude Code, omp, pi) in their workflow
  • Terminal enthusiasts seeking a customizable, dotfile-managed environment
  • Users of omarchy Linux who want to overlay custom configs without replacing the base
  • Neovim users looking for a structured configuration layered with LazyVim

Use cases

  • Bootstrapping a complete development environment with a single install script
  • Managing global CLI tools (herdr, hunk, ghui, etc.) via mise across multiple machines
  • Running multiple AI agents (omp, pi) with separate configs and extension directories
  • Overlaying custom Neovim, terminal, and agent configs onto a pre-existing OS setup like omarchy

Strengths

  • Uses mise to provide a reproducible, step-by-step install with safety prompts and dry-run support
  • Tracks only configuration files—runtime artifacts, secrets, and caches are intentionally excluded
  • Overlay mechanism (symlink-each) lets the workspace coexist with omarchy's default configs without conflict
  • Supports both macOS and Linux, with OS-specific tool provisioning where needed

Considerations

  • Primarily targets terminal-based agent development; users expecting a full GUI or IDE may find it limited
  • Installation requires understanding of mise, dotfiles, and potential manual conflict resolution (when a target 'differs')
  • Some tools (Ghostty, Neovim on macOS) are macOS-only; Linux users need to adapt or use alternatives

README quick start

workspace

This is the configuration for the tools I use for agent driven development.

I'm trending towards doing as much in the terminal as I can and biasing towards tools with high levels of customizability.

Uses the fantasic mise to bootstrap everything.

What's inside

PathToolInstalled bySymlinked to
mise/workspace.tomlGlobal mise tool config[dotfiles]~/.config/mise/conf.d/workspace.toml
herdr/config.tomlherdrmise/workspace.toml -> herdr~/.config/herdr/config.toml
herdr/plugins/dev-layout/Herdr plugin: four-pane dev layoutpost-tools hook -> herdr plugin link
nvim/LazyVimmise/workspace.toml -> neovim (macOS; omarchy on Linux)~/.config/nvim (overlay)
ghostty/configGhosttypost-tools hook (brew --cask)~/.config/ghostty/config (macOS only)
ghui/config.jsonghuimise/workspace.toml -> npm:@kitlangton/ghui~/.config/ghui/config.json
hunk/config.tomlhunkmise/workspace.toml -> hunk~/.config/hunk/config.toml
omp/agent/config.ymlompmise/workspace.toml -> github:can1357/oh-my-pi~/.omp/agent/config.yml
omp/agent/extensions/omp extensions(config only)~/.omp/agent/extensions (overlay)
omp/plugins/pi-claude-bridge/ + .tgzOMP plugin: Claude Code provider + AskClaude toolpost-tools hook -> npm install packaged local plugin~/.omp/plugins/node_modules/pi-claude-bridge
pi/agent/settings.jsonpimise/workspace.toml -> npm:@earendil-works/pi-coding-agent~/.pi/agent/settings.json
pi/agent/extensions/pi extensions(config only)~/.pi/agent/extensions (overlay)
skills/effect-setup/agent skill(config only)~/.agents/skills/effect-setup
skills/mise-setup/agent skill(config only)~/.agents/skills/mise-setup

Global tools

The CLI tools (herdr, hunk, ghui, omp, pi, stylua, atuin) are declared in [mise/workspace.toml](./mise/

Description

Where my work happens

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191