Use mecatui

mecatui is Mecatl's interactive terminal client. Use it to work with an agent, inspect tool activity, respond to permission requests, and resume sessions.

Start with Run your first local session. It runs a private Mecatl server in the same process, so you can learn the client before deploying a separate server.

Choose how to connect

• Run mecatui to start a private, embedded server for your local workspace.
• Run mecatui connect ADDRESS to use a separately deployed mecated or mecak8s server. The server controls the workspace, model credentials, storage, and permissions.
• Run mecatui sessions to browse stored sessions before opening one.

Follow Connect to a server when you are ready to move the server out of your local process.

Guides

• Run your first local session
• Connect to a server
• Manage sessions
• Use the TUI
• Keybindings
• Commands and memory
• Customize mecatui
• Themes
• Customize the status line
• Troubleshooting

To deploy or operate the server, see the guides for mecated and mecak8s.