Documentation

Everything you need to start coding.

Use this guide with the Windows desktop application. Product behavior described here reflects the current internal beta.

Installation

Download the Windows installer from the download page and verify its SHA-256 before running it.

SHA-256: DCC508E6ED65406DA039C1358645E0C9FAED6E6EF9B031A8BE6DB6AF4752D11F
Version: Version 2.2.5 Lite Internal Beta
Supported: Windows 10/11, 64-bit

The current build is unsigned, so Windows SmartScreen may show a warning. Do not disable Defender or SmartScreen globally.

Creating an account

Create a Sharuma account with your name, email address and password. A verification email is sent after registration. You can also sign in from the desktop application using email or Google when Google authentication is configured for the environment.

Desktop sign-in uses a device authorization code. Open the verification page shown in the app, sign in, and approve the device. The app completes sign-in automatically.

Activating the Free Trial

The Sharuma Free Trial is a one-time, 24-hour trial after account creation and email verification. It is not activated automatically at registration.

  1. Create an account and verify your email.
  2. Sign in to the desktop application and authorize the device.
  3. In the welcome screen, select Start Your Free 24-Hour Trial, then Activate Free Trial.
  4. The trial card shows time remaining, tasks remaining and usage percentage.

The trial cannot be restarted by signing out, reinstalling or authorizing another device. When it ends, the app shows Your Free Trial Has Ended and offers plan information. Existing sessions and project files are preserved.

Opening a project

Use the desktop project picker to open a local folder. Projects, drafts and coding sessions remain on your computer. Sharuma does not upload your project to the account service to open it.

Using Sharuma Flash and Sharuma Pro

Sharuma Flash is designed for fast, efficient coding assistance. Sharuma Pro is designed for more demanding development workflows.

Model availability depends on your active plan. The Free Trial uses Sharuma Flash only. Sharuma does not allow models that are outside your active plan.

AI chat and coding

Describe the task in the composer. Sharuma can inspect project files, propose changes, generate implementations, assist with debugging, generate tests and refactor code as part of a coding session. The agent can work across multiple rounds while your plan and trial limits are rechecked.

File editing

The agent can create and update files in the local project through the desktop application. Review the changes in the session and your editor before committing. Project files stay in the workspace you opened.

Terminal permissions

Terminal commands run locally. The desktop asks for approval according to its permission settings. Review commands before approving them, especially commands that delete data, install software or access the network.

Usage limits

Sharuma keeps usage calculations accurate and transparent. The desktop shows the authoritative five-hour, weekly, monthly and trial values. The UI does not grant access when your allowance is exhausted.

If a request cannot fit inside the remaining allowance, Sharuma declines it before it is sent.

Troubleshooting

The local coding engine did not start

Use Retry local engine on the startup recovery screen. If it still fails, restart the app and use Export logs before contacting support. This is a local startup issue, not an account or subscription error.

The trial is not available

Confirm that your email is verified and that the account has not already used its one-time trial. Trial availability is controlled by Sharuma and checked against your account.

A model is unavailable

Your plan may not include that model. Check the plan access on the pricing page.

I was signed out

Sign in again from the desktop welcome screen. Your local sessions and project files remain on the device.

Contact support