Shimpz
After installation

Create your first Team

A Team is your private workspace. It keeps its own conversation, Assistants, Integrations, model settings, and files separate from every other Team.

  1. Open the local Admin

    Browser · local Admin
    http://127.0.0.1:7777

    Open the exact address printed by shimpz install. The address above is the default; a configured SHIMPZ_PORT changes the port.

    When the installed port is not 7777, use the printed address for normal Admin work and open https://local.shimpz.com when you need to authorize an Assistant Integration.

    Create the initial Admin password when asked. Use at least 15 characters and do not reuse it elsewhere. Then scan the QR code with an authenticator app and enter its current six-digit code. This TOTP factor is required before Admin creates your first Supervisor session.

    A passkey is optional. To register one, open the same port as http://localhost:7777 (or replace 7777 with your configured port), complete password and TOTP verification, then choose Create passkey. Passkeys require that exact localhost address or an admitted HTTPS domain and remain bound to it. Return to the printed 127.0.0.1 address for automatic Integration authorization; there, use your authenticator code instead of the localhost-bound passkey.

  2. Name the Team

    On a clean installation, Shimpz opens Create a Team automatically. Enter a simple name, such as Marketing, then choose Create Team. You cannot enter chat without a Team.

  3. Configure the Brain

    Open the Team's model settings, choose OpenAI or Anthropic and a supported model, then use the key button beside the chat composer to save the matching API key. The key is write-only: Shimpz never shows it again.

    The Brain writes the Team's replies and decides when an Action can help. Do not paste API keys, passwords, or OAuth tokens into the message box.

  4. Verify the Team can reply

    Open Chat and send a message that does not require an Assistant:

    Reply with this Team's name and one short sentence.

    Continue when the Team returns a complete reply without asking for model configuration. This proves the Team, model selection, and provider key are ready before you add an Assistant.

During a reply

Follow the Team's execution

After you send a message, Chat shows the server operations the Team has actually entered, such as team-context, model, action, action-delivery, and reply-validation. The last phase is the Admin's exact public-response validation, while action-delivery retires the durable result journal after the model accepted it. A moving line means that exact operation is still active. A duration appears only after the server measures its completion; the display does not invent a percentage or estimated finish time.

When the answer arrives, open Execution stages below it to inspect the completed receipt. This receipt contains technical phase names and timing metadata only—not hidden reasoning, prompts, Action arguments, results, API keys, or Integration credentials.

Every new message starts at the top of the conversation area with room below it for the answer. Shimpz does not pull the page back down when the answer arrives, so you can scroll and read while a long response grows.

Optional

Open a remote Linux installation safely

For the smallest remote trust boundary, forward the private Admin through SSH, leave the terminal open, and use http://127.0.0.1:7777 in your browser. This retains the automatic loopback OAuth return and does not place a TLS terminator in front of your Supervisor session.

Terminal · your computer
ssh -L 7777:127.0.0.1:7777 user@your-server

If shimpz install used another SHIMPZ_PORT, keep the local side at 7777 and change only the remote destination. For example, an installed port of 49123 uses:

Terminal · your computer
ssh -L 7777:127.0.0.1:49123 user@your-server