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 bash
source selfedit.sh

# @COMMAND one              does this and that
one() {
    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