devman is a minimal workspace orchestrator for tmuxp, Claude Code, and Neovim.
It discovers .devman/ workspaces, builds an index, and launches tmux sessions
with the right editor context.
- Python 3.11+ (use
uvfor environments). - tmux + tmuxp for session management.
- Neovim (
nvim) if you want editor/session bootstrapping. - Claude Code (
claude) is required for Claude integration.
A workspace is any project root that contains a .devman/ directory. The
minimum requirement is the directory itself, but a devman.toml file provides
metadata and paths.
Example .devman/devman.toml:
[workspace]
name = "my-app"
[tmuxp]
workspace = "workspace.tmuxp.yaml"
session_name = "my-app"
[claude_code]
interaction = "interaction.md"
emit_project_config = false
[nvim]
init = "nvim/init.lua"
listen = ".devman/.state/nvim.sock"
sessions_dir = "sessions"
default_session = "home.vim"For the full schema, see docs/workspace-schema.md.
./cli/devman index rebuild./cli/devman./cli/devman switch <name|tag|path>- Review the workspace schema in
docs/workspace-schema.md. - Configure Claude Code in
docs/claude-integration.md. - If something fails, check
docs/troubleshooting.md.