lman

A terminal-based UI for managing multiple LLM agent CLI sessions across projects, with built-in git worktree support.

Status

Pre-alpha. Under active development.

Development setup

This project uses mise to pin the Go toolchain and dev tools. After cloning:

# one-time, install mise itself
curl https://mise.run | sh

# inside this repo
mise trust       # opt in to running ./mise.toml
mise install     # installs the pinned Go and golangci-lint

Once that's done, go, golangci-lint, and the make targets will all use the project-pinned versions whenever you're inside the repo.

Building

make build

Running tests

make test

Default keybindings

All actions use the ctrl+e prefix by default.

• ctrl+e p open project
• ctrl+e n new session
• ctrl+e r rename focused session
• ctrl+e j next session
• ctrl+e k previous session
• ctrl+e x close session
• ctrl+e R restart focused session
• ctrl+e z toggle fullscreen
• ctrl+e ? show help
• ctrl+e q quit

UI config

Set the default sidebar width in config.toml:

[ui]
sidebar_width = 36

You can also drag the sidebar's right edge at runtime to resize it.

Linting

make lint

Architecture

See spec/lman/architecture.md for design decisions and spec/lman/requirements.md for the requirements.

License

MIT