devman

Minimal workspace orchestrator for tmuxp + Claude Code + Neovim.

Features

• Discover .devman/ workspaces under configured roots.
• Cache index at ~/.cache/devman/index.json.
• Launch tmuxp sessions with Claude Code + Neovim windows.
• Switch workspaces and load Neovim sessions via remote commands.
• Claude Code requires the claude CLI to be installed.

Quick start

./cli/devman index rebuild
./cli/devman

Documentation

• Getting started
• Workspace schema
• Claude integration
• Troubleshooting

NixOS + Home Manager (flakes)

Use a flake input pinned with git+ to avoid GitHub API rate limits.

inputs.devman.url = "git+https://github.com/<org>/<repo>?ref=<branch>&rev=<commit>";
# Optional: add &dir=path/to/subdir if the flake isn't at the repo root.

Home Manager:

home.packages = [
  inputs.devman.packages.${pkgs.system}.default
];

NixOS:

environment.systemPackages = [
  inputs.devman.packages.${pkgs.system}.default
];

Usage:

devman index rebuild
devman

Development

Use devenv + uv for local development.

uv sync
uv run ./cli/devman --help

Config validation helper

Use cli/setup_config.py to validate .env.example, .toml.example, or .yaml.example files against their target configs.

uv run ./cli/setup_config.py validate .env.example