devbox

Prerequisites

Install mise for managing tool versions:

brew install mise

Setup

git clone https://github.com/viqueen/devbox.git
cd devbox
# install tools (node, pnpm, neovim, starship)
mise install
# install dependencies
pnpm install
# configure shell (exports, PATH, aliases, mise config symlink)
./setup.sh config_box
# optional: workspace-aware prompt (starship)
./setup.sh config_prompt
# optional: neovim with lazy.nvim
./setup.sh config_vim

What's Included

Tools (via mise)

Defined in .mise.toml and symlinked to ~/.mise.toml by config_box:

Tool	Purpose
node	Node.js runtime
pnpm	Package manager
neovim	Editor
starship	Shell prompt

Prompt

A workspace-aware starship prompt that color-codes the hostname segment based on which workspace you're in:

Workspace	Color
workspaces/viqueen/*	orange
workspaces/{primary_org}/*	purple
workspaces/{secondary_org}/*	blue
~/	green
elsewhere	red

Configure orgs via env vars: VIQUEEN_DEVBOX_PRIMARY_ORG, VIQUEEN_DEVBOX_SECONDARY_ORG.

Editor

Neovim with lazy.nvim plugin manager. Config lives in cli/nvim/ and is scoped via NVIM_APPNAME=devbox (stored at ~/.config/devbox/nvim/).

Plugins: edge colorscheme, lualine, nvim-tree, telescope, treesitter, mason + lspconfig.

Scripts and Binaries

Quick navigation

. dev # navigate to devbox
dev edit # open dev script for edit
dev edit myscript # create a new script

Available commands

dev -h # housekeeping and generic scripts
mvnup -h # maven version upgrade
jsonf # json pretty format
image -h # docker things
gitar -h # git things

All scripts source selfedit.sh (edit mode via nvim) and selfdoc.sh (auto-generated help from @COMMAND annotations):

#! /usr/bin/env bashsource selfedit.sh
# @COMMAND one does this and thatone() {
echo"one"
}
eval$@if [[ -z$1 ]];then$0 -h
fi

Atlassian scripts

Extracted to atlassian-devbox:

brew tap viqueen/atlassian-devbox
brew install atlassian-devbox