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.
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.
- Create an account and verify your email.
- Sign in to the desktop application and authorize the device.
- In the welcome screen, select Start Your Free 24-Hour Trial, then Activate Free Trial.
- 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.