Skip to content

Releases

v0.17.0

Choose a tag to compare

@ChrisVip001 ChrisVip001 released this 12 Nov 18:22

Joy v0.17.0 — first release you can actually install

Earlier tags (v0.5.0, v0.8.0, v0.16.0) never produced a Release: the macOS Intel
build used the macos-13 runner image, which GitHub retired on 2025-12-04, so
that job sat in the queue until the run was cancelled and the dependent release
job was skipped. The build now runs on macos-15-intel. This is the first
version with downloadable binaries.

Install

Download the archive for your platform, extract, run:

tar -xzf joy-v0.17.0-<your-target>.tar.gz && chmod +x joy
DEEPSEEK_API_KEY=… ./joy dashboard        # -> http://localhost:7777

Four targets: aarch64-apple-darwin, x86_64-apple-darwin,
x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu.
No API key? Ollama runs fully offline (JOY_PROVIDER=ollama).
Docker: docker build -t joy . then
docker run --rm -p 7777:7777 -v joy-state:/home/joy/.joy joy.

Highlights

Inspectable memory. Every turn writes one append-only ledger row. Open a row
in the dashboard's memory drawer to see that turn's full entry stream — the
retrieval gate's decision, tool calls and timings, which model answered, token
usage. The <home>/memory OKF bundle carries a rebuildable FTS5 index; a
background worker consolidates and mirrors it. The memory center adds a library
with ledger:… chips back to source turns, a six-section context meter, and
on-demand /compact [focus].

The dashboard speaks English and Chinese. 266 strings go through t(), with
data-i18n* attributes for static markup; a sidebar button switches language
and remembers it, and a fresh browser follows navigator.language.
just check-i18n fails on missing, unused or placeholder-mismatched
translations. The dashboard also remembers which conversation you were reading
across reloads, and returns to your previous scroll position when you switch back.

Turns finish their own work. When the step cap cuts a turn off, a built-in
gate checks the todo list and continues (up to JOY_AUTO_CONTINUE_MAX),
carrying working memory and a fresh step slice instead of restarting from
chat_log. When the budget is genuinely gone, the reply says what is left and
traces/*.jsonl records steps / continues / unfinished.

Deterministic replay evals. joy eval --replay pins event ordering for
compaction, approval timeouts, streamed output and MCP reconnects. Events match
as an ordered subsequence; a case that asserts nothing is refused on load.
just check now includes eval-replay.

Cheaper turns. Split system prompt with an Anthropic cache breakpoint and
cached-token accounting, thin/full souls, skill catalog with on-demand bodies
(read_skill), deferred tool loading (find_tools), oldest-first result
trimming. 29 built-in tools (21 always on, 8 behind switches) plus MCP servers.

Recovery and safety. Recovered tasks recheck acceptance and record spend;
tool batches persist intent before execution, and recovery suspends batches with
unknown results for reconciliation rather than replaying them; background jobs
use restart-safe IDs. Batched subagents are read-only and carry distinct session
names. Configuration now has one source of truth — just check-config-docs
fails unless every JOY_* the code reads appears in .env.example and both
configuration docs.

Full detail in CHANGELOG.md / CHANGELOG.zh.md.

Known limitations

  • Discord / WeChat / Lark gateways are implemented but have never been connected
    to those platforms. Only Telegram has.
  • File writes and shell execution are off by default (JOY_WRITE=1 /
    JOY_EXEC=1); the writable boundary is Unix-only for now.
  • The Homebrew formula now carries the real v0.17.0 sha256, but the tap itself
    (and the PyPI / npm channels) is not published yet.
  • Full list: docs/limitations.md.

If anything above does not match what you see, please open an issue — a failed
install is more useful to this project than a star. Releases are planned every
1–2 weeks; Watch → Custom → Releases if you only want those.