Binarius AI Code Studio — Product documentation

Version 1.0.0 · Binarius Systems Private Limited

License

Binarius AI Code Studio is licensed under the Eclipse Public License 2.0 together with the Binarius end user license terms, which cover license keys, AI agents and services, data and privacy, warranty and liability. Every installation includes a 28-day free evaluation; after that a license key is required to keep using the product. Reinstalling does not restart the evaluation.

System requirements

MinimumRecommended
Operating systemWindows 10 64-bit, macOS 12, Ubuntu 22.04 / Debian 12 (x86-64)Windows 11, macOS 14+ on Apple silicon
Memory8 GB16 GB (32 GB for large local models)
Disk2 GB+5–9 GB for a local model
Local AICPU only (slow)GPU with 8 GB+ memory, or Apple silicon
Online agentsNode.js 22 or later, internet access and the agent's account or API key
JavaIncluded (Java 21). New projects can target Java 17, 21 or 25.

Download

Download from the download section of the website. Each platform is available as an installer and as a zip file:

PlatformInstallerZip (portable)
Windows 10/11 x64binarius-ai-code-studio-1.0.0-setup.exebinarius-ai-code-studio-1.0.0-windows-x64.zip
macOS (Apple silicon)binarius-ai-code-studio-1.0.0-macos-arm64.dmg…-macos-arm64.zip; Intel: …-macos-x64.zip
Linux x86-64binarius-ai-code-studio-1.0.0-linux-amd64.debbinarius-ai-code-studio-1.0.0-linux-x64.zip

Installation

Windows — installer

  1. Run binarius-ai-code-studio-1.0.0-setup.exe. If Windows SmartScreen shows Windows protected your PC, choose More info > Run anyway.
  2. Accept the license terms, choose the folder (default C:\Program Files\Binarius AI Code Studio).
  3. Keep Install local AI (Ollama) ticked to work offline; optionally create a desktop icon.
  4. Finish and start Binarius AI Code Studio from the Start menu or desktop.

Silent install for companies: setup.exe /VERYSILENT /SUPPRESSMSGBOXES /POLICYURL=https://your-server/aijt-policy.json. Uninstall from Settings > Apps; your workspaces and settings are kept.

Windows — zip

  1. Unzip to a short path such as C:\BAICS (long paths can fail on Windows).
  2. Start BAICS.exe. (Do not start other .exe files in the folder.)

macOS

  1. Open the .dmg and drag Binarius AI Code Studio to Applications (or unzip the zip into Applications).
  2. First start: if macOS says the app cannot be checked, right-click the app > Open > Open, or System Settings > Privacy & Security > Open Anyway.

Linux

Opening the tool for the first time

  1. Choose a workspace — the folder where your projects are kept (e.g. C:\Users\you\baics-workspace). Tick Use this as the default to skip the question next time.
  2. The welcome page opens. The evaluation banner shows how many days are left.
  3. Choose your AI: Set up local AI (offline, downloads Ollama and the model once) or Sign in to an agent (Claude Code, Codex, Gemini CLI, GitHub Copilot CLI).
  4. The AI Assistant tab is on the right of the editor (Window > AI Assistant if closed).

Activating a license key

When the evaluation ends, the product asks for a key at startup (Activate or Exit). You can enter it earlier in Preferences > Binarius AI Code Studio > License > Enter license key…. Keys look like AIJT1.… and are checked offline.

Creating a project

With the AI Assistant (recommended)

  1. In the AI tab, set Project to (workspace folder).
  2. Describe the program, e.g. Create a library management system in core Java with JUnit tests or Create a REST API for books with Spring Boot, and press Ctrl+Enter.
  3. The agent creates a Maven project named after the task, writes the classes and tests; the IDE builds it, runs the tests and the program, and asks the agent to fix anything that fails. The new project is selected, so your next message continues on it.

By hand

File > New > Project > Maven Project or Java Project (or the New project card on the welcome page). Existing projects: File > Import > Existing Maven Projects or Projects from Git.

Using the AI Assistant

  1. Pick the Agent and, if you like, the Model; choose the Project.
  2. Decide on Auto-approve: on lets the agent work on its own; off asks before each step and shows every change for review.
  3. Type the request and send it. Watch the steps in the transcript and the progress bar; Stop cancels.
  4. Read the result: ✔ Done means it built, the tests passed and the program ran. Otherwise the transcript says what is still failing.
  5. Continue with follow-ups (add a search by author), open earlier chats with History…, and commit through your chosen Git mode.

Every part of the AI Assistant and every setting is explained in detail below.

Features and usage

Binarius AI Code Studio is a complete Java IDE (Eclipse-based, with Java, Maven and Git support) plus an AI Assistant tab that connects to coding agents: Claude Code, Codex, Gemini CLI, GitHub Copilot CLI, or a local model that runs on your computer.

Install

First run in three steps

  1. Choose a workspace folder (where your projects live).
  2. On the welcome page, click Set up local AI (offline) or Sign in to an agent.
  3. In the AI Assistant tab, type what you want, e.g. Create a project that demonstrates OOP concepts with tests, and press Ctrl+Enter.

Welcome page

Shown when the IDE starts. Cards open the AI Assistant, set up local AI, sign in to an agent, create or import projects and open settings. Clicking an example prompt puts it into the AI tab.

Open it: Help > Welcome to Binarius AI Code Studio. Turn off at startup: untick Show this page when the IDE starts at the bottom of the page, or in Preferences.

Workspaces and projects

A workspace is a folder with your projects. The Project box in the AI tab chooses where the agent works: one project, or (workspace folder) to let the agent create new projects. Projects the agent creates are imported and selected automatically; your next message continues on them.

Switch workspace: File > Switch Workspace, or the last entry Open another workspace… in the Project box, or the AI tab menu (⋮) > Switch Workspace.

The AI Assistant tab

Open it: Window > AI Assistant (it is on the right of the editor by default).
ControlWhat it does
AgentWhich coding agent works for you. The status in brackets shows ready, not signed in or not installed.
Status dotGrey = not started, yellow = starting or working, green = ready, red = an error happened.
ProjectWhere the agent works (see Workspaces).
Git modeHow changes reach Git for this project: Manual, Branch or Pull request (see Git).
Auto-approveOn: the agent writes files and runs its tools without asking. Off: every step asks and every change is shown for review (see Approvals).
Model / Options…The agent's model and other settings such as reasoning effort or temperature (see Models).
ⓘOpens this guide at the relevant section.
Input boxYour request. Ctrl+Enter sends.
Send / StopSend the request; Stop cancels the running reply and rejects pending changes.
New chatSaves the current chat and starts a fresh conversation (the agent restarts).
History…Opens an earlier chat of this project; your next message continues it (see Chat history).
Progress barShows what is happening with a percentage: starting, working (steps done), checking, running.

The transcript shows your messages, the agent's replies, each tool call (e.g. Write Main.java [done]) and notices from the IDE (ℹ information, ⚠ problems, with buttons to fix them). The plan pane below the transcript shows the agent's plan when it sends one.

Tab menu (⋮): Sign in to Agent, Preferences, Switch Workspace, Set Up Local AI, User Guide, Export Audit Log.

Agents and sign-in

AgentNeedsSign in
Local (Ollama)Nothing online after setupNo sign-in; see Local AI
Claude CodeNode.js 22+, Claude subscription or API key⋮ > Sign in to Agent opens a terminal for the Claude login, or set ANTHROPIC_API_KEY
CodexNode.js 22+, ChatGPT account or API keySign in to Agent opens the browser for ChatGPT, or set OPENAI_API_KEY
Gemini CLINode.js 20+, Google account or API keySign in to Agent opens Gemini in a terminal: choose Login with Google; or set GEMINI_API_KEY
GitHub Copilot CLINode.js, GitHub Copilot planSign in to Agent runs copilot login (browser and one-time code), or set GH_TOKEN

Online agents are downloaded on first use (via npx) and run under their publishers' own terms. Your prompts and the files they read are sent to that provider.

API keys: Preferences > Binarius AI Code Studio > select the agent > Edit… > Environment (NAME=value per line). Keys are kept in the operating system's secure storage. Add your own agent: Add… with any command that speaks the Agent Client Protocol (ACP).

Models and options

The Model box lists the models the selected agent offers; Options… holds its other settings. The list is read when you select the agent (it starts briefly in the background) and your choice is remembered per agent.

AgentModel listOther options
Claude Codee.g. Default, Sonnet, Opus, HaikuEffort, mode, fast mode
CodexOpenAI modelsReasoning effort, mode
Gemini CLIAuto and Gemini models–
LocalModels installed in OllamaTemperature
GitHub Copilot CLINot published by Copilot; set under Options > Model (or Auto on plans without model choice)Mode, Allow all

Temperature (local models)

How much randomness the model uses: 0 exact and repeatable (fixing errors), 0.2 recommended for code, 0.5 more varied ideas, 0.8–1 creative but more mistakes (not for code).

Local AI (offline)

The local agent runs a model on your computer with Ollama: code never leaves the machine and no account is needed.

Set up: welcome page > Set up local AI, or ⋮ > Set Up Local AI, or simply send a message with the Local agent selected. The IDE installs Ollama if needed (Windows installer option, macOS ~/Applications, Linux ~/.local/share/aijt/ollama), starts it and downloads the model with progress (first time only, several GB).

Writing requests

The first message on a project with code makes the agent read it first and summarise it before working, so it keeps your packages, naming and libraries.

Framework and Java version

The agent reads the request first, then decides:

Java version of new projects: Preferences > Binarius AI Code Studio > Java version of new projects (17, 21 or 25; default 21). The agents use only that version's features. Projects are named after the task (e.g. book-api) with a matching package (e.g. com.bookapi).

Build, test, run and fix

After every reply that changed files, the IDE checks the work itself:

  1. Build the changed projects and collect compile errors.
  2. Tests: if there are none, the agent is asked to write JUnit 5 tests; then they are run.
  3. Main class: if a runnable program has none, the agent is asked to add one; a run configuration is created so you can run it with the Run button.
  4. Run the program and read its output (servers that keep running count as started).
  5. Anything failing is sent back to the agent with the errors and log, up to 5 fix rounds.

The transcript ends with ✔ Done (build clean, tests passed, program ran) or with what is still failing.

Settings: Preferences > IDE tools: After the agent changes files, build and run tests. Run after build and the number of rounds are in the same place.

Approvals and reviewing changes

Switching agents and follow-ups

Change the Agent box at any time. The new agent starts on its next message, first analyses the existing code and is told which agent worked on it before and what it was asked. Use Use my last message with … in the notice to resend your request to the new agent.

Git and GitHub

ModeWhat happens
ManualThe agent only edits files; you commit yourself (Team menu or Git Staging view).
BranchThe work goes to an ai/<task> branch; after a verified task you get Commit and Discard buttons.
Pull requestLike Branch, then Push and open pull request pushes the branch and opens a GitHub pull request (draft by default).
Choose the mode: the Git box next to the project (asked once per Git project). GitHub: Preferences > GitHub token (fine-grained token with Contents and Pull requests read/write; kept in secure storage), API URL for GitHub Enterprise, drafts, Co-authored-by trailer. If the working tree has uncommitted changes you can stash them or continue in Manual mode.

Chat history

Every chat is saved per project: your messages, the agent's replies, tool calls and IDE notices, with the time of each entry and secrets removed.

Open an old chat: History… in the AI tab > choose a chat > Open. It is shown again and your next message continues it (the agent gets the earlier conversation as context). Files: <project>\.baics\chats\<time>-<agent>.md (readable) and .jsonl. Settings: Preferences > Audit log > Save every chat per project, Chats folder (${project}, ${workspace}; a shared folder gets one subfolder per project).

Audit log

A record of AI activity for teams and compliance: sessions, prompts (secrets removed; optional), tool calls, approvals, file changes (paths, hashes and line counts, never file contents), verification results, model changes and Git actions.

Files: <workspace>\.baics\audit\yyyy-MM-dd.jsonl. Export for managers: File > Export AI Audit Log (CSV), or ⋮ > Export Audit Log, or the button in Preferences. Settings: Preferences > Audit log (on/off, include prompt text, folder, days to keep).

Admin policy

Administrators control the IDE for a team with a policy file aijt-policy.json: allowed agents, default agent, enforced Git mode, local model server, whether shell commands are allowed, forced review, audit and chat history settings, updates. Locked settings appear greyed out with Set by your organization's policy.

Where: next to BAICS.exe, or -Daijt.policy=<file or https URL> in BAICS.ini, or the installer option /POLICYURL=https://…. An invalid policy falls back to safe defaults and shows why.

Evaluation and license keys

Every installation can be used free for 28 days from its first start (the AI tab and the welcome page show the days left). After that a license key is required: at startup the IDE asks for it (Activate or Exit). Reinstalling does not restart the evaluation.

A key (AIJT1.…) names the licensee, the number of seats and the expiry date. It is checked on your computer; no internet connection is needed. Request one at the Binarius AI Code Studio website (License page).

Enter a key: when asked at startup, or Preferences > Binarius AI Code Studio > License > Enter license key… (kept in secure storage). Renewal: enter the new key the same way.

Preferences

Open: Window > Preferences > Binarius AI Code Studio, or ⋮ > Preferences in the AI tab. Changes take effect with Apply or Apply and Close; Restore Defaults resets this page. Settings with a grey, locked look are set by your organization's admin policy.

Agents table

The coding agents available in the AI tab's Agent box.

ColumnMeaning
NameName shown in the Agent box. (built-in) marks agents that ship with the product; (not allowed by policy) marks agents your admin has disabled.
CommandThe command that starts the agent. Built-in online agents run through Node.js npx with a pinned version (e.g. npx -y @google/gemini-cli@0.61.0 --acp). The Local agent is built in and configured in the fields below.
EnvironmentHow many environment variables (such as API keys) are set for this agent, e.g. 2 variables; empty when none. Values are not shown and are kept in secure storage.
ButtonWhat it does
Add…Adds a custom agent: a name, the command line of any program that speaks the Agent Client Protocol (ACP), and optional environment variables. It then appears in the Agent box.
Edit…Changes the selected agent: its command (e.g. a newer version, or --model <name>) and its environment, one NAME=value per line, e.g. ANTHROPIC_API_KEY=…, OPENAI_API_KEY=…, GEMINI_API_KEY=…, GH_TOKEN=…. Double-clicking a row does the same.
RemoveRemoves a custom agent. Built-in agents cannot be removed (an admin policy can hide them).

Claude Code, Gemini CLI, Codex and Copilot CLI need Node.js. Sign in once with each agent's own login (⋮ > Sign in to Agent in the AI tab) or put its API key into the agent's environment.

Local agent

Settings of the built-in local agent, which works with Ollama, LM Studio, vLLM or a company server with an OpenAI-compatible API.

FieldDefaultMeaning and advice
Endpointhttp://localhost:11434/v1Address of the model server's OpenAI-compatible API. The default is Ollama on this computer. For a company server use its https address; an API key for it goes into the Local agent's environment as AIJT_LOCAL_API_KEY=….
Modelqwen2.5-coder:14bThe model used by default. Use a coding model that supports tool calling. qwen2.5-coder:7b for PCs with less than 16 GB RAM or no GPU. It is downloaded automatically on first use. You can also switch per chat in the AI tab's Model box.
Temperature0.2Randomness of the answers: 0 exact, 0.2 recommended for code, 0.5 more varied, 0.8–1 creative but error-prone.
Max tool calls per request25Most steps (file writes, builds, tests) the local agent may take for one message. Raise it for big tasks; it stops with a message when reached.
Max tokens per reply4096Longest answer the model may write at once. Larger values allow bigger files but take longer.
Request timeout (s)600How long to wait for one answer from the model. Slow computers or large models may need more.
Test connection–Checks that the endpoint answers, lists the models it has, and says if the chosen model still needs to be downloaded.

Environment for all agents

Variables given to every agent, one NAME=value per line, for example HTTPS_PROXY=http://proxy.company:8080 or NODE_EXTRA_CA_CERTS=C:\certs\company.pem. Kept in secure storage. An agent's own environment (Edit…) overrides a variable with the same name.

Approvals

OptionDefaultMeaning
Review every file change before it is written (recommended)OnEach change opens a Compare editor with Apply and Reject when Auto-approve is off in the AI tab. With Auto-approve on, changes are written directly (unless a policy forces review).
Allow read-only tool calls (read, search) without askingOffWhen on, agents may read and search files without a permission question; writes and commands still ask.

IDE tools

OptionDefaultMeaning
Let agents use IDE toolsOnAgents can create IDE projects, build, run Maven and JUnit, and read problems and logs the same way you see them. Off: agents work with files only.
After the agent changes files, build and run tests; ask it to fix failuresOn (5 rounds)The verified changes loop: build, tests, main class, run, and automatic fix rounds.
Java version of new projects2117, 21 or 25. Projects the agents create compile for this Java release and use only its features. 17 and 21 run with the included Java; 25 needs a JDK 25 under Window > Preferences > Java > Installed JREs.
Show the welcome page when the IDE startsOnOpens the welcome page at startup.
Send an anonymous installation count once a dayOnLets Binarius count installations: a random id, the version, the OS and whether the copy is in evaluation or licensed. No code, prompts, files or personal data. Turn it off here; an admin policy with "telemetry": false turns it off for everyone.

Git and GitHub

The Git mode itself (Manual, Branch or Pull request) is chosen per project in the AI tab.

FieldMeaning
GitHub tokenNeeded only for Pull request mode. Create a fine-grained token on GitHub (Settings > Developer settings) with Contents and Pull requests read and write on the repository. Kept in secure storage; shows not set until entered.
GitHub API URLLeave automatic for github.com. For GitHub Enterprise Server: https://<host>/api/v3.
Open pull requests as draftsOn: pull requests are opened as drafts for review before merging.
Add a Co-authored-by trailer for the AI agent to commitsOff: commits carry only the AI-Agent trailer. On: also a Co-authored-by line naming the agent.

Audit log and chat history

FieldDefaultMeaning
Keep an audit log of AI activityOnWrites the audit log (one JSONL file per day).
Include prompt textOnPrompt text is stored with secrets removed. Off: only its length and a hash.
Folder${workspace}/.baics/auditWhere the audit files go; ${workspace} is the workspace folder. Can be a shared network folder.
Keep for (days)180Older daily files are deleted at startup.
Save every chat per projectOnKeeps the chat history.
Chats folder${project}/.baics/chats${project} is the project folder. A folder without it (e.g. a shared drive) gets one subfolder per project.
Export audit log (CSV)…–Saves all kept events as a spreadsheet file.

Updates

OptionMeaning
Check for updates on startupLooks for a newer version on the configured update site when the IDE starts.
Channelstable for released versions, beta for previews.

License

ItemMeaning
Status lineEvaluation days left, or the licensee and expiry of your key, or that the evaluation has ended.
Enter license key…Paste the key you received (starts with AIJT1.). Checked offline.
Remove keyRemoves the key from this computer.

Where things are stored

WhatWhere
Chat history (both sides)<project>\.baics\chats\
Audit log<workspace>\.baics\audit\
Agent technical logs (also in the Console view)<workspace>\.baics\logs\<agent>-<date>.log
IDE error log<workspace>\.metadata\.log
Settings<workspace>\.metadata\.plugins\org.eclipse.core.runtime\.settings\com.aijt.core.prefs
API keys and tokens (encrypted)%USERPROFILE%\.eclipse\org.eclipse.equinox.security\secure_storage
Local modelsOllama's model folder (%USERPROFILE%\.ollama)

Add .baics/ to .gitignore if chats should not be committed with the project.

WhereWhat
Window > AI AssistantShow the AI tab
Help > Welcome to Binarius AI Code StudioWelcome page
Help > Binarius AI Code Studio User GuideThis guide
File > Export AI Audit Log (CSV)Audit export
AI tab ⋮ menuSign in, Preferences, Switch Workspace, Set Up Local AI, User Guide, Export Audit Log
Ctrl+EnterSend the request
Run buttonRun the program the agent built (run configuration)

Updates

If your company or Binarius provides an update site, the IDE checks it at startup and offers updates (Preferences > Updates: on/off, stable or beta). Help > Check for Updates checks manually.

Troubleshooting

ProblemWhat to do
Agent shows not signed in⋮ > Sign in to Agent, or set its API key in Preferences.
Agent shows not installedInstall Node.js (22+) from nodejs.org, then restart the IDE.
Local model is slow or times outPick a smaller model (qwen2.5-coder:7b) or raise Request timeout in Preferences > Local agent.
Model list shows only DefaultSelect the agent again after signing in; the list is read in the background.
Project not visible after the agent created itIt is imported automatically after the reply; otherwise File > Import > Existing Maven Projects.
Not done after fix roundsRead the errors in the transcript and send a message to continue, or be more specific.
An agent fails to startSee its log in the Console view or <workspace>\.baics\logs.

© 2026 Binarius Systems Private Limited · Based on Eclipse · Eclipse Public License 2.0