Skip to content

Select language

Current language: English

Settings

Edit page

Click the gear icon in the header to open Settings. The left side lists the groups and their tabs; the right side shows the selected tab. Some tabs save changes as you make them; others have their own Save button.

Groups can be collapsed. HagiCode remembers which ones you left open.

GroupTabs
GeneralGeneral Settings, Notifications, Confirm Prompts, About
Appearance and interfaceStartup Splash, Status Bar Scroll, TokenMonitor, Mermaid Appearance, Kanban Right Panel
Sessions and conversationSession List, Chat View, AgentCLI Interactive Control, Agent resource limits, Error Retry, Post-state actions
Proposals and planningProposal Creation, Planning Direction, Proposal Stage Diagram
Input and efficiencyHaginput, Common Phrases, Quick Actions, Comments
Projects and integrationsProject Icon, GitHub, Git, Code Server, OmniRoute
Lifestyle and wellbeingAchievements, Break Reminder, Salary Tracker
SystemData Management, Debug, Danger Zone

Some controls are only active with the TurboEngine DLC and show as locked without it.

General

General Settings

General Settings tab with Brand Customization and the back-to-top button position

  • Brand Customization sets a custom header logo, application title, brand link, and browser title. A live preview shows the result. These controls are visible for preview but locked until the TurboEngine DLC is active.
  • Back to Top Button Settings chooses where the back-to-top button appears in a session, for example Bottom Right.

Notifications

Notifications tab with channels and a table of status rules

Turn notifications on, then choose the channels: Toast notifications, Browser notifications (the browser must allow them), Speech synthesis, and Sound Settings. The Status rules table lets you pick, for each session status such as New, Drafted, Executing, Waiting for Reply, Execution Complete, or Archived, which channels fire and which sound plays. The play button tests a sound.

Confirm Prompts

Confirm Prompts tab with switches for each confirmation dialog

A master switch plus one switch per confirmation dialog: before a Super Commit All commit, before generating a proposal, moving it to pending execution, executing immediately, or archiving it, and before archiving or deleting selected conversations. Turning prompts off saves clicks but makes mistakes more costly. Reset to Default restores the defaults.

About

About tab with the HagiCode platform version and community resources

Shows the version and build date and links to the official About page with the full community list.

Appearance and interface

Startup Splash

Startup Splash tab with the startup splash switch, the image selection mode, and the fixed image picker

Decides which splash image HagiCode shows when it starts. Changes apply the next time HagiCode starts.

  • Show startup splash image: when turned off, startup shows only the brand name, the version, and a loading indicator.
  • Image selection has three modes: Random on every startup, Random once per day (chosen on the first start of the day and kept for the rest of it), and Fixed image.
  • With Fixed image selected, the picker below lists the available splash images; click one and it is shown on every startup.

These controls are visible for preview but locked until the TurboEngine DLC is active, as shown in the screenshot.

Status Bar Scroll

Status Bar Scroll tab with display switches and the list of current promotions

Chooses whether the status bar scrolls and which sources it uses: Tips and Promotions. Turning scrolling or promotions off needs an active TurboEngine subscription. The tab lists the current promotions.

TokenMonitor

TokenMonitor tab with the status bar switch and HostHub fields

Shows today’s token usage and cost from the TokenMonitor desktop app in the status bar. Nothing is read while the switch is off. For near-real-time updates, enter both the HostHub address and HostHub secret; leave either empty to read TokenMonitor’s local data file instead.

Mermaid Appearance

Mermaid Appearance tab with the Default and Archify-inspired presets

Chooses the look of Mermaid diagrams: Default or Archify-inspired. The choice is saved only in this browser and changes visuals only.

Kanban Right Panel

Kanban Right Panel tab with display mode options and a preview

Choose what the right side of the session board shows: Hidden, GitHub Discussion, or the Quick Operations Panel with quick actions and repository status (the default). A live Preview shows the effect.

Sessions and conversation

Session List

Session List tab with project scope, sort mode, and display options

  • Project Scope chooses which projects feed the All Sessions board: All Projects or a Custom Selection. Click Save to apply it.
  • Session Sorting is either Smart Sorting (by runtime status and recent activity) or Custom Sorting with your own prioritized rules.
  • Session Display Settings includes whether archived sessions stay visible in the list.

Chat View

Chat View tab with chat mode, debug metadata, and long message options

  • Default to Edit Mode for Normal Chats decides whether new normal sessions start in edit mode, where the Agent may modify files, or read-only.
  • Show debug metadata entry points adds debugging entries to chat messages.
  • Auto-collapse long messages shows long history messages as a preview with an expand control.
  • Simplified historical tool calls collapses older tool calls into a short summary attached to the next visible message.

AgentCLI Interactive Control

AgentCLI Interactive Control tab with one switch per Agent CLI

One switch per Agent CLI decides whether generated OpenSpec and HagiTask prompts still tell the Agent that the run is non-interactive. With a switch off (the default) the hint is included. This only changes the wording of generated prompts.

Agent resource limits

Agent resource limits tab with a Memory group and a CPU group, each with a switch and a limit dropdown

Limits how much memory and CPU each Agent CLI, and the commands it runs, may use. A changed limit applies only to Agents started afterwards. The tab has a Memory group and a CPU group.

  • Limit memory per agent: when turned on, every new Agent run, together with all the processes it starts, is held to the limit below.
  • Limit per agent: choose the limit from the dropdown; the default is 4 GB. The description lists the corresponding soft limit, Node.js heap size, swap, and task count cap. Hagicode enforces the limit by starting the Agent in a systemd user scope.
  • Limit CPU per agent: when turned on, every new Agent run, together with all the processes it starts, shares the CPU time set below.
  • Virtual CPU cores per agent: counted in virtual cores, the logical processors this host reports; the default is 1. The description shows the chosen cores out of the host total.

If the current system does not support one of these limits (it is not Linux, systemd-run is missing, systemd cannot create a user scope, or the cpu controller is not delegated), the tab shows the reason, that switch is unavailable, and Agents start without that limit.

Error Retry

Error Retry tab with the default retry policy and per-CLI overrides

Automatic retry for failed runs. The Default Policy sets the maximum number of retries and the delay before each retry, with a tail delay for later attempts. The default schedule waits 30, 30, 30, then 60 seconds. CLI Overrides let each Agent CLI follow the default or use its own schedule.

Post-state actions

Post-state actions tab: a Super Commit session is archived automatically after Execution completed

Decides what HagiCode does automatically after a type of session enters a certain state. Rules run in the order listed. The built-in rule currently targets Super Commit sessions (sessions started from a Super Commit message):

  • Enabled: when turned on, the rule takes effect.
  • When the session reaches: the state that triggers the rule, for example Execution completed.
  • Then: the action to take, for example Archive session.

The default rule archives Super Commit sessions automatically once they finish executing, so they leave the session list.

Proposals and planning

Proposal Creation

Proposal Creation tab with the recent repository slot count

Sets how many recent repository cards the proposal repository selector shows at the top. Choose 0 to hide the row.

Planning Direction

Planning Direction tab with a matrix of planning directions per Agent CLI

A matrix of the planning directions the proposal flow proposes by default for each Agent CLI: explore mode, change map, interaction flow, prototype, architecture, API sequence, and the editable and reference repository scope. Individual Agents can override the defaults.

Proposal Stage Diagram

Proposal Stage Diagram tab with Full and Compact display modes and a live preview

Sets how detailed the stage list in the proposal drawer is: Full shows stage labels and descriptions, Compact shows labels only. This affects only the drawer’s side rail, not the main flow diagram.

Input and efficiency

Haginput

Haginput tab with the input mode and remote mode settings

Intelligent input. Choose Disabled, Doubao Local Voice, or Haginput Remote Mode to relay text from a phone or second device without opening the local microphone. The tab shows the mode status, an auto-connect option, a sound for received text, and a test box.

Common Phrases

Common Phrases tab with category visibility, path sources, and custom groups

This tab combines the former Standard Phrases and Common Requirements into two parts.

Phrases: manages the reusable @ phrase tokens in the message box. Choose which categories and path sources (projects, vaults, proposal sessions, recent projects, custom paths) appear in the @ picker, and create custom phrase groups with Add Group.

Common requirements:

The list of common requirements in the lower half of the Common Phrases tab

Reusable requirement snippets that you can add to a proposal request with one click, for example No docs / tests, Self commit, Output English (it follows the interface language), Ask before edit, and No backward compatibility. Only requirements for the current interface language are listed. Use Add Common Requirement to create your own, and the edit and delete buttons to manage them; built-in system presets can be brought back with Restore missing system presets.

Quick Actions

Quick Actions tab with an empty command list and execution history

Configured Commands lists the custom commands you add with Add Command. Execution History records when they ran.

Comments

Comments tab with line comment and file comment template lists

Save the comment templates you use often, in two lists: Line Comments and File Comments. Use Add Comment to create one and Save to keep your changes.

Projects and integrations

Project Icon

Project Icon tab with the default icon mode and the icon collection

  • Project Icon Mode sets the default style for new projects: Game Icon (a random colorful icon, the default) or Text Abbreviation (initials from the project name). A single project can override it in its project details.
  • Icon Collection controls which icons can be picked. Use Show All, Enable All, Disable All, Random 50, and Refresh, or click an icon to toggle it.

GitHub

GitHub tab showing the connected local gh CLI session and setup instructions

Uses your local GitHub CLI (gh) session to sync sessions and import GitHub data. The tab shows the connection status and granted scopes, Refresh status, and Copy login command. Tokens stay in memory for the current page session and are never written to local storage. If gh is not signed in, follow the Local gh setup steps shown on the tab.

Git

Git tab with Git profiles, status monitoring, and Super Commit defaults

  • Git Profiles hold the author identities that Super Commit can use. Create at least one before you start a Super Commit so the prompt always names a clear author.
  • Automatically refresh and monitor Git status checks active projects regularly. This can raise disk activity, especially on Windows or with many repositories. Maximum monitored Git repositories limits concurrent watchers (default 15).
  • Super Commit default behavior chooses what the primary Super Commit button does: Open confirmation panel first, or Commit immediately with your saved profile and defaults. Further options set whether to push or rebase after a commit by default.

Code Server

Code Server tab with the resolved configuration and runtime status

A display-only view of the resolved Code Server configuration (host, port, authentication mode, source) and the latest runtime snapshot. Editing Code Server settings is not supported here.

OmniRoute

OmniRoute tab with the integration switch, API endpoint, runtime status, and model catalog

Enables the shared OmniRoute integration. Set the API endpoint and optional API key, use Test connection, and choose which Agent CLIs consume OmniRoute’s model catalog. The right side shows the runtime status and the cached model catalog. When the integration is off, model management falls back to the original system defaults. See OmniRoute for installation.

Lifestyle and wellbeing

Achievements

Achievements tab with the daily progress popover switch

Toggles the daily achievement progress popovers in the status bar. Global milestone notifications and data sync stay active either way. See Status bar and progress.

Break Reminder

Break Reminder tab with timer status and reminder themes

A timer that nudges you to drink water, stretch, or stand up. It shows the last and next reminder and today’s cycles, and lets you pick a reminder theme such as Basic. The reminder appears in the status bar.

Salary Tracker

Salary Tracker tab with daily salary, work hours, and unit emoji

A playful per-minute earnings counter. Enter a Daily salary and Work hours per day; the per-minute rate is the salary divided by work hours times 60, and a salary of 0 turns it off. Pick one of 20 unit emojis and choose whether the status bar shows the indicator.

System

Data Management

Data Management tab with the database catalog, save catalog, and data cleanup

Shows the active save and its data folders (save root, config root, data root). The Save Catalog lists saves and lets you activate a ready save safely. The Workspace switcher moves between the Primary Database, Message Database, and Image Storage tools. Data Cleanup shows database information and cleans up archived session message data to free storage.

Debug

Debug tab with SignalR logging, HagiPower adjustment, and DLC options

Tools for development builds:

  • SignalR Log prints SignalR events and messages to the console in real time.
  • HagiPower Adjustment edits the shared public pool directly in development. It does not change normal production accounting.
  • Enable DLC explicitly opts the TurboEngine DLC in or out through backend configuration, because local development has no internal enable flag.

You do not need this tab for normal use.

Danger Zone

Danger Zone tab with the Reset system data button

Reset system data resets persisted state and deletes the primary database records and message shards of the active save. Images, plugins, repositories, and other saves are not affected. The application keeps running, and a restart is recommended afterwards. This cannot be undone.

Appearance, theme, and language

Two buttons in the header change how HagiCode looks without opening Settings.

Choose theme dialog with theme families in light and dark variants and an auto-switch panel

Theme opens the theme chooser. Each family comes in a Light and a Dark variant and applies immediately. Families include Standard, Spring, Summer, Vacation, Autumn, Winter, Lunar New Year, Soccer, Cyberpunk, School, and Space Travel. Auto-switch rotates between light or dark themes on a fixed interval from 1 to 240 minutes.

Select Language dialog with English selected and the other nine interface languages

Language opens the language dialog. Choose a language and click Confirm. HagiCode supports English, 简体中文, 繁體中文, 日本語, 한국어, Deutsch, Français, Español, Português (Brasil), and Русский.

HagiCode

HagiCode is an agentic coding workspace. Rich, convenient UI interactions make planning, agent execution, and project work approachable and easy to navigate, creating an engaging development experience.

Explore an engaging development experience through rich, convenient UI interactions.

Visit HagiCodeRead the documentation
  • SmartOpenSpec workflows turn intent into an executable path, from proposal to design, tasks, and a shipped change.
  • EfficientMulti-agent execution keeps research, implementation, and review moving in parallel, across several repositories and the Agent CLIs you already use.
  • InterestingRich, convenient UI interactions make planning, agent execution, and project work approachable and easy to navigate.

Download for Windows

Get it from Microsoft StoreAll downloads

Turn ideas into shipped software.

HagiCode is an agentic coding workspace. OpenSpec workflows plan the change, multi-agent execution carries it out, and Hero Scenario makes the long run visible, so ideas become shipped software.

Smart
OpenSpec workflows turn intent into a path from proposal to shipped change.
Efficient
Multi-agent execution runs research, build, and review in parallel.
Fun
Rich UI interactions make planning, agent work, and projects easier to follow.