Quick start
The shortest path is: install the desktop app, open a folder, connect a provider, and give one task a clear outcome.
- 01
Install Ascora ADE
Download the current build for Windows x64 or Linux x64 and launch the desktop app.
- 02
Open a project
Add any local folder from the launcher. ADE loads its tree and creates a workspace without uploading the project.
- 03
Choose a backend
Start LM Studio or Ollama for a local model, configure OpenRouter, select an installed CLI, or sign in through WProvider.
- 04
Describe one outcome
Create a task and ask for a concrete change. The selected backend and model are pinned to that task when you submit.
- 05
Watch the run
Follow reasoning, tool calls, command output, elapsed time, and token usage while the agent reads, searches, edits, runs, and verifies.
- 06
Review the change
In Ask mode, approve or reject proposed writes and commands. Use Auto-apply only when you want the task to continue without each prompt.
The browser demo uses the real renderer against mock data. It never touches your disk, shell, models, or network; install the desktop app for real project work.
Providers
Each task remembers its provider and model independently. New tasks inherit the workspace choice until you select a different backend.
LM Studio
Local · OpenAI-compatible
The default local provider. Start an OpenAI-compatible server, then select its model in ADE. The default base URL is http://localhost:1234/v1.
Ollama
Local · OpenAI-compatible
Keeps a separate URL and model selection from LM Studio. ADE uses http://localhost:11434/v1 by default and checks availability in the background.
OpenRouter
Hosted API
Enable it in Agent backend settings, save an API key, refresh the model list, and select a model. The key is normalized before requests.
CLI agents
Codex · Copilot · Claude · Gemini · GLM
ADE normalizes each CLI stream into the same chat surface. Provider-specific controls include sandbox, reasoning, permission, model, and approval modes where supported; Codex presets include gpt-5.6-terra and gpt-5.6-lunna.
Ascora WProvider
Signed-in web chats · no API key
Sign in to Qwen, DeepSeek, Alice, Mistral, Claude, Grok, Gemini, or ChatGPT. ADE drives the selected web composer in a hidden browser and keeps sessions in its own partition.
In an SSH context, only LM Studio and Ascora WProvider are selectable agent backends. ADE disables providers that cannot drive the remote host and explains why in the picker.
Agent workflow and tools
The chat is an execution surface, not just a text answer. Tool cards expose what the agent asked for, what happened, and whether it succeeded.
read / listInspect project files and directories.search_filesSearch literal text or regex with glob, case-sensitive, and up-to-10-line context options. SSH uses a matching grep-backed path.edit / writePropose or apply file changes under the current workspace.shellRun a command and return streamed output, errors, and exit status.web_searchQuery DuckDuckGo and return ranked titles, URLs, and snippets.web_fetchFetch one URL and return readable, HTML-stripped text with time and size bounds.Ask before changes
Proposed writes and commands pause for approval. Use the diff and tool output to decide whether to apply or reject them.
Auto-apply
The same loop continues without per-action approval. You can still follow its tools live and stop the targeted run.
Files and images
Attach multiple files or images from the composer. ADE imports them into the workspace with de-duplicated names and passes their relative paths to the backend.
Background tasks
Active runs keep progressing while you change workspaces, tasks, or SSH terminals, then restore their live state when reopened.
Tasks and archives
Search, collapse or expand every workspace together, rename a project without moving its folder, and reopen archived conversations read-only before restoring them to the task list.
Reusable Skills
Save instructions as Skills and enable the ones a task needs. ADE adds enabled Skills to the agent context without changing the project itself.
Blueprints
A Blueprint is a persistent scenario independent of any one project. It can coordinate named WProvider agents with separate roles, instructions, services, and conversation sessions.
Build the graph
Arrange a protected Start node and action nodes on the draggable canvas. Normal wires define dependencies; disconnected nodes stay draft-only. Switch between Graph and List views at any time, and annotate the canvas with persistent sticky notes while you pan, zoom, or fit the whole workflow.
Fan out and fan in
Every matching outgoing route runs in stable order. A node with several incoming wires waits for all connected predecessors before it starts.
Route on results
A wire can be Always, Otherwise, succeeded, failed, contains, not-contains, equals, or not-equals, with optional case sensitivity for text comparisons.
Repeat safely
One dedicated Repeat connection can return to an earlier node for 2–20 passes. The graph also enforces a 2,000-action-attempt safety bound.
Coordinate through Blueprint Hub
Connect one or several saved scenarios to a shared team prompt. Each Blueprint runs its own pipeline while the Hub shows its status and latest result live.
Action types
Agent mode
Enable agent mode for all participants or only selected agent steps. Each enabled step can take up to 16 model turns with web_search and web_fetch. Bind a local project to add file, search, edit, write, and shell tools. Project-changing Blueprint tools run autonomously, so verify the selected workspace before launch.
Variables, schedules, and the log
Text fields can interpolate {{input}}, {{last}}, {{now}}, {{steps.ID}}, and {{agents.ID}}. In graph mode, {{last}} resolves from the current node or its direct predecessors, and team context includes completed graph ancestors. Start manually or set a minute interval; scheduled runs work while Ascora ADE is open and skip a new pass if the previous one is still active. The execution log persists step status, output, errors, agent tool calls, and timestamps. Stopping a run cancels its active search, shell, and web tools.
WProvider uses one shared browser driver. Agent turns are queued and executed one at a time even when several Blueprints are active. For reliable conditions, ask a deciding agent for an exact marker such as RESULT=PASS or RESULT=FAIL and compare it on outgoing wires.
Git, terminal, and SSH
Editing, source control, commands, and remote sessions share the same dockable interface.
Git
Stage files, inspect diffs, switch branches, commit, and push. The split diff viewer syntax-highlights changed code with old/new gutters and shows per-file additions, deletions, rename-aware stats, or a binary badge. ADE can draft a commit message from staged changes.
Terminal
The integrated xterm.js interface drives a line-oriented platform shell. Run ordinary commands, builds, tests, and scripts; copy selected text with Ctrl/Cmd+C or right-click. Full-screen TUIs and mid-command stdin are not supported. Agent command cards report streamed output and the exit code.
SSH
Connect to a remote host, use its terminal, and keep multiple persisted chats per host. Reopening a chat reconnects and restores its transcript and pinned backend. LM Studio and WProvider are the supported SSH agent backends.
Analytics and privacy
Analytics turns locally recorded usage into a view of your own work: tokens, sessions, messages, projects, routers, and models are presented inside ADE.
Estimated cost
ADE applies public API prices per model to estimate total and monthly spend. Free local and WProvider usage is recorded as zero direct API cost and also shows an API-equivalent savings estimate; external subscription costs are not included. CLI subscriptions are estimated as though their tokens were bought through an API.
Model share over time
A 100%-stacked chart shows each model's weekly token share across the last 12 weeks, with exact shares in the tooltip.
Activity patterns
The weekday × hour-of-day heatmap uses local time and exposes each cell by pointer and keyboard. Daily charts and expandable project rows show model-level detail.
Six languages
Choose English, Russian, Ukrainian, German, French, or Italian from the rail. Analytics labels, dates, filters, tooltips, and number formatting follow supported locale catalogs.
Local model requests stay on your machine with LM Studio or Ollama. Selecting a hosted API, CLI service, WProvider, web tool, or network Blueprint action contacts that service. Monaco and the normal project workspace remain bundled locally.
Troubleshooting
Start with the status bar and the active context. ADE keeps connection and validation failures visible instead of silently changing providers or graph paths.
LM Studio or Ollama is unavailable
Start the corresponding local server, open Agent backend settings, confirm the base URL, refresh models, and use Test. ADE probes both servers in the background and keeps an unavailable local option disabled with a provider-specific hint.
A WProvider service is not ready
Open that service's sign-in window and finish authentication until its real composer is available. Sign-in state is tracked separately per service; signing out one service does not clear every WProvider login.
A Blueprint will not start
Make sure Start reaches at least one executable node, normal connections do not form a cycle, and the Repeat edge returns along the current path. File, Command, and local agent tools also require a selected project whose directory is available.
A scheduled Blueprint did not run
Ascora ADE must remain open. A new interval is skipped while the same Blueprint is already active. Invalid scheduled graphs are recorded as failed runs in the log with their validation error.
A provider is disabled over SSH
This is expected for backends that cannot operate on a remote host. Switch to LM Studio or Ascora WProvider, the two SSH-capable agent backends documented for 1.3.0.
Electron exits without opening a window (developer launch)
If you launch from a terminal that sets ELECTRON_RUN_AS_NODE=1, unset it before starting Electron. That variable makes Electron run as plain Node.
ADE reports that it is using the JSON store
This is a supported fallback. SQLite uses the optional native better-sqlite3 module; on Windows it needs the Visual Studio Desktop development with C++ workload. Install that workload and reinstall better-sqlite3 to enable SQLite.