@takemo101/asem
v0.0.2
Published
Local agent Session manager CLI
Readme
@takemo101/asem
asem is a local agent Session manager for AI-assisted development. It helps a human or parent agent create child Sessions, exchange Messages, collect Reports, and inspect local work from a CLI, TUI Cockpit, or stdio MCP server.
Manual: https://takemo101.github.io/asem/
Repository: https://github.com/takemo101/asem
Install
Recommended with Bun:
bun install -g @takemo101/asemnpm also works when bun is available on your PATH:
npm install -g @takemo101/asemThe package installs the asem binary. It is built for Bun-based execution, so install Bun before running asem.
Verify the installed version:
asem --versionQuickstart
cd /path/to/your/repo
asem init --interactive
asem doctor
asem session create reviewer-1 --profile reviewer --prompt "Review the current diff"
asem message list
asem tuiWhat it provides
- Local Sessions: create and inspect child agent Sessions in a Workspace and Worktree Root.
- Messages and Reports: keep durable local communication history between parent and child Sessions.
- Multiplexer Templates: launch through tmux, zellij, herdr, rmux, or project-local Templates.
- Agent Profiles: shape child prompts with explicit Profiles such as
reviewer,worker, andplanner. - TUI Cockpit: inspect Sessions and local activity from a keyboard-first terminal surface.
- Stdio MCP server: expose primitive Session and Message operations to compatible AI clients.
- Integration Target setup: register MCP or install Skill guidance for supported external AI clients.
asem is intentionally small. It is not a task board, scheduler, hosted service, workflow engine, or result evaluator.
Built-in Agent Templates
asem ships with built-in Agent Templates for common agent CLIs:
claude,codex,pi,gemini— positional prompt seeds the interactive session.agy— uses--prompt-interactivefor the initial prompt.opencode— uses--promptfor the initial interactive TUI prompt.kimi— starts the interactive TUI bare and pastes the prompt after a boot delay (paste_prompt: true); it uses-mfor model selection.
Use asem doctor to check that the selected Agent CLI is installed and reachable.
More information
See the manual for concepts, CLI usage, TUI behavior, Agent Profiles, MCP setup, Skills, and configuration:
