Connect Desktop to your instance
Before you start
Section titled “Before you start”You need:
- A Hacker Sidekick account that’s a member of your organization. Use the email your administrator added. If you aren’t sure, ask them.
- The enterprise-enabled build of Hacker Sidekick Desktop. Enterprise mode is currently available in Desktop’s beta builds (version 1.4.0-beta.1 or later). Your administrator or your Hacker Sidekick contact can give you the installer. Beta installs keep updating on the beta channel.
Connect
Section titled “Connect”You don’t need to enter an address. Desktop finds your organization from your account.
-
Open Hacker Sidekick Desktop and sign in with your Hacker Sidekick account as usual.
-
Desktop looks up which organizations your account belongs to and, if there’s exactly one, connects to its instance automatically.
-
Check the status bar at the bottom of the window. It reads Managed by <your organization>. Click it to see which account is registered to the organization and to open the admin portal.
-
Optionally, open Settings → Enterprise (beta). It shows Managed by <your organization> and whether the org system prompt and the org RoE template are active.
Desktop checks your organizations when you sign in and every 30 minutes. If you were only just added, click Check for organizations in Settings → Enterprise (beta) instead of waiting.
If you belong to more than one organization
Section titled “If you belong to more than one organization”Settings shows a card for each organization, plus Use my personal account. Desktop asks you to choose: click the one you want. Choose automatically clears your choice again.
If one of your organizations is marked Restricted, its members always use its instance. You can’t pick another organization or your personal account while you belong to it.
If Desktop doesn’t find your organization
Section titled “If Desktop doesn’t find your organization”Settings → Enterprise (beta) says “No organization found for this account - using your personal account.” Check, in order:
- You’re signed in with the account your administrator added. A personal account with a different email won’t be a member.
- Click Check for organizations.
- If it still isn’t found, ask your administrator for your instance address and use the manual setting below.
If Settings says “Signed in with an API key: organizations cannot be discovered”, sign out and sign back in with your account instead.
Manual instance address
Section titled “Manual instance address”Under Settings → Enterprise (beta), expand Advanced: manual instance URL (overrides
discovery). Paste the address your administrator gave you, for example
https://acme.hackersidekick.com, and save. It must start with https://.
A manual address overrides the organizations Desktop finds on its own. Once connected, the field locks so a stray edit can’t drop the connection; click Edit to change it. Clear it to go back to automatic discovery.
If your organization rejects the account
Section titled “If your organization rejects the account”The status bar shows <your organization> rejected this account when the instance refuses your requests, usually because you aren’t (or are no longer) a member. You stay signed in to Hacker Sidekick, but requests to the instance fail until your administrator grants access. See Troubleshooting.
Switch to your personal account
Section titled “Switch to your personal account”In Settings → Enterprise (beta), click Use my personal account. Desktop goes back to the standard Hacker Sidekick service, removes the organization’s skills and MCP servers, and stops applying the org system prompt. Your own skills, settings and sign-in aren’t affected. Click your organization’s card to switch back.
This option isn’t available while you belong to a Restricted organization. If you set a manual instance address, clear it as well.
