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, which runs a private Mecatl server in the same process.

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.
• Run mecatui login ADDRESS to enroll with a remote server's OIDC issuer. This is separate from local provider configuration and credentials.

Configure providers for an embedded local server with the providers command:

mecatui providers setup
mecatui providers

setup configures an embedded server; add NAME defines a custom provider, and login, logout, and set-default manage it. For credential sources, secret safety, and provider selection, see Choose models and providers. The standalone deployment guide owns the operator providers and credential_store schema.

mecatui login ADDRESS authenticates this client to a remote server; it does not configure that server's providers. ToolHive is external and owns its LLM credentials and lifecycle; use thv llm tooling for ToolHive setup.

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.