Use Mecatl

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.

For local model access, follow Choose models and providers. For an operator-provided deployment, follow Connect to a remote deployment.

Guides

• Run your first local session
• Install mecatui
• 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.