Skip to content

Nagi documentation

Install, learn, and configure Nagi. Start on the path that matches you — no multiplexer experience required.

New to terminal multiplexers?

You don’t need to learn shortcuts to start. Nagi is mouse-first: click panes, drag borders, split and switch from right-click menus.

Quick start →

Coming from tmux or zellij?

You already know the model. The prefix is ctrl+b, panes persist, detach and reattach work the way you expect.

Concepts → · Keybindings →

Already running an AI coding agent? Let it do the onboarding. Paste this prompt:

Help me understand and set up Nagi. Read https://cod-hash-studios.github.io/nagi/agent-guide.md first, then walk me through it step by step.

The guide teaches your agent Nagi’s concepts, setup, configuration, and common fixes, so its answers stay accurate instead of improvised.

Agents

See supported agents, detection behavior, integrations, custom labels, and direct attach.

Understand agents →

Session state

Understand detach, restart restore, pane history replay, native agent resume, and live handoff.

Compare state paths →

Configuration

Configure keybindings, themes, sidebar behavior, notifications, scrollback, and advanced options.

Configure Nagi →

API

Control Nagi from scripts, tools, and agents through the CLI and local socket API.

Read the API guide →

Plugins

Author local executable workflow plugins with manifest actions and event hooks.

Write a plugin →

Marketplace

Share plugins from GitHub today and tag your repo to be listed when the marketplace launches.

Publish a plugin →