Last Updated: 7/23/2026

The Jolli Agent

The Jolli Agent is Jolli’s AI assistant: you give it a documentation task and it drafts the work for you. This article covers the Agent itself, the Changesets its edits pass through for review, and Gap Analysis - the Agent working on its own to catch docs that have drifted from code. Automation ties them together.

For the manual writing surface - the editor, floating toolbar, auto-save, version history - see Editing & Organizing.

Working with the Agent

The AI Assistant lives in the Jolli Agent tab. You give it a task (“write an Article about our API’s auth flow”; “update the deployment guide for the new Docker setup”); it drafts content as a Changeset; you review before anything reaches the Space.

Modes

Pick from the toolbar above the chat. Exec is the default outside of guided workflows that use Auto.

Context

The Jolli Agent tracks which Article, Folder, or Space the conversation is working on. A breadcrumb under the chat header shows it (Engineering > API Docs > Authentication API). Context is dynamic by default (follows your navigation) or snapshot (locked to a specific target, shown with a (fixed) label).

If context changes mid-conversation, the AI sees a small note in its next turn. Click the breadcrumb to override.

Multiple conversations

Each task gets its own conversation. The left sidebar lists every conversation, grouped by date (Today / Yesterday / Last 7 days / earlier), with a New Chat button at the top. Click any past conversation to resume it; the AI sees the prior turns and continues where you left off.

Delete a conversation from its three-dot menu - useful for clearing out one-off explorations.

Changesets & review

A Changeset is a group of proposed edits to a Space - like a pull request for documentation. The Jolli Agent’s drafts and Gap Analysis’s drift fixes both land as Changesets. You review, apply, or cancel before anything reaches the Space.

Direct edits in the Article editor save immediately and don’t create Changesets. It’s the AI-proposed edits that go through this gate.

Reviewing

Open any Changeset from its sidebar entry or from the Inbox notification that announced it. The detail view shows affected Articles on the left, a diff in the middle (additions green, deletions red), and the state / author / history at the top. Click any Article to see its proposed content; you can edit inline and your edits stay in the Changeset.

Two primary actions:

• Apply Change Set - queues the Changeset to merge onto the latest published content, then publishes it into the Space. It moves through Publishing to Published, and the Space’s content is now current. The live Site is a separate build - it won’t reflect the change until its next publish (see Jolli Sites).
• Cancel Change Set - discards the whole Changeset (Discarded). The Space is untouched.

You can reject individual Articles within a Changeset before applying - that Article is dropped, the rest proceed.

If a Changeset was drafted against content that has since changed, you may also see Merge or Merge & Apply to reconcile it, and - if a publish hits conflicts - Force Publish. Changesets pass through a few intermediate states (Proposed, Reviewing, Ready) on the way to Published.

Git-backed Spaces publish through GitHub

Some Spaces are bound to a git repository instead of storing content in Jolli (set up in Managing a Space → Storage). Those Spaces don’t use Changesets at all. Their publish flow pushes a work branch (named jolli-doc-<hex>) and opens a GitHub Pull Request against the backing’s source branch instead. Jolli opens and tracks those PRs for you.

• Review happens on GitHub, not in the Changeset detail view. Open PRs and merged/closed ones show up in the Gap Analysis Pull Requests panel, split into Open and Closed tabs, each with a direct Open on GitHub link.
• If a PR picks up merge conflicts, the panel shows a “conflicts, awaiting auto-rebase” hint - Jolli auto-rebases the branch on its next sweep, so you usually don’t intervene.
• The two automation toggles below still work but take on PR semantics: auto-apply reads as “auto-merge pull requests,” and auto-update reads as “create pull requests when Sources update.”

Gap Analysis (automated drift)

Gap Analysis is the AI scan that compares your Sources (code repos, uploads) against your Articles and flags drift. When it finds drift, it drafts fixes as a Changeset.

The difference from a Jolli Agent task you start yourself: you start an Agent task. The system starts a Gap Analysis run.

Drift shows up in a few common ways:

• Missing docs - a new module, endpoint, or feature has no matching Article.
• Outdated content - an Article describes the old behavior of something that changed.
• Incomplete coverage - a section mentions a feature briefly but the Source now has a lot more detail.

Triggers

Configure under Space Settings → Automation. Turn on Auto-update from sources, then pick how runs fire - one or both:

• Listen for GitHub events - near-real-time; fires when a push or merge arrives at a connected Source via webhook (requires the GitHub App).
• Check on a schedule - polls connected Sources on an interval (every N days, at a time you set). Useful when push-driven runs would be too noisy.

Job Activity

Each Gap Analysis run (labeled Jolli Doc Review) shows in the Job Activity panel with trigger, status, and timestamp:

• Running - still working.
• Changes made - found drift; Changeset produced.
• No changes - docs in sync.
• Failed - click for error details.

There’s no manual run button. To force an immediate run, push a small change to the tracked branch or adjust the schedule to fire now.

Automation & auto-apply

By default, every AI-proposed Changeset waits for a human review. The auto-apply toggle removes that wait: when it’s on, routine AI-suggested updates apply and publish without a manual pass.

• Find it under Space Settings → Automation as the Auto-apply change sets toggle. On a git-backed Space the same control reads as Auto-merge pull requests (and needs the GitHub App to have merge access).
• Auto-apply only applies to Changesets from Gap Analysis. Changesets from the Jolli Agent chat always require manual review - for hands-off Agent tasks, use Auto mode instead.
• It’s a shared-Space setting; the toggle is disabled on your Personal Space.
• It’s off by default for most Spaces - reviewing every change is safer than silently publishing every AI suggestion. (The guided import flow is the exception: it applies imported Articles without a manual pass.)

Turn it on once you trust the pipeline - Spaces where drift detection runs frequently and changes are predictable (small wording fixes, auto-generated reference updates) are the best candidates. For where this setting lives alongside the rest of a Space’s configuration, see Managing a Space.

For scheduled automation that generates docs on a cadence or on GitHub activity - distinct from the Agent and Gap Analysis - see Workflows.

Next steps

• Managing a Space - Sources, automation settings, and where auto-apply lives.
• Workflows - scheduled, hands-off doc automation.
• Jolli Sites - publish the reviewed content at a URL.