Dark Energy

Support

Dark Energy 1.0 · macOS 27 or later · Apple silicon

Email: support@darkenergy.app
We read everything and answer within a couple of business days.

Getting started

What the first launch asks for

Folders for Dark Energy to learn from, a folder for its agent to work in, Claude Code’s folder if you use Claude Code, and the model download. Every one can be skipped and changed later in Settings › Folders & Models.

The model won’t download

The model comes from Apple as part of the app, about 4 GB to chat and about 4 GB more the first time you train. Check that the Mac is online and has around 10 GB free. If a download is interrupted, it tries again the next time you chat.

It can’t see a folder

Dark Energy runs in the App Sandbox, so macOS shows it only the folders you have chosen. Add the folder in Settings › Folders & Models. A folder you choose there includes everything inside it.

Training

Chat says training is using the memory

Training and chat each need most of a 16 GB Mac’s memory, so on Macs with less than 32 GB they take turns. Press Pause Training, chat, and press Resume when you’re done; the cycle carries on from the step it stopped at.

How long a cycle takes

On a MacBook Air with 16 GB of memory, a 400-step cycle takes about 45 minutes. Training uses the GPU hard: keep the Mac on power, and expect other GPU-heavy apps to slow it down. Low Power Mode slows it too.

“Waiting for checks”

A cycle is ready to use as soon as it finishes. Its checks — a set of behaviour and skill tests — run later, once the Mac has been idle for ten minutes, and stop the moment you come back. They pick up where they left off.

What it trains on

Text, Markdown, LaTeX and source code in the folders you chose to learn from. PDFs are indexed so its agent can search them, but they are never trained on. Build products, dependencies and version-control folders are skipped.

The agent

A command says git, python3 or swiftc is missing

Those come with Apple’s Command Line Tools. Install them by running xcode-select --install in Terminal, or install Xcode.

It can’t build or run what it compiled

Mac App Store apps aren’t allowed to run programs they have just compiled, which rules out swift build, swift test and running a compiled binary. Its agent checks Swift with swiftc -typecheck instead, and can run git, python3 and Swift scripts.

LaTeX documents aren’t turned into PDFs

The same rule applies to TeX, which lives outside the places a sandboxed app may run programs from. Its agent writes the .tex file; compile it with your TeX editor or in Terminal.

Putting a change back

Every answer that changed files lists them, with an Undo button that puts them back as they were. A copy of what was replaced is kept for a month.

Turning off the web

Settings › Folders & Models › Agent: switch off Allow web search and fetching web pages.

Reporting a problem

Email support@darkenergy.app and include:

Please don’t send your documents or chats unless we ask; we don’t need them to fix most problems.