Genesis Docs

tokenjuice is an optional bundled plugin that compacts noisy exec and bash tool results after the command has already run.

It changes the returned tool_result, not the command itself. Tokenjuice does not rewrite shell input, rerun commands, or change exit codes.

Today this applies to PI embedded runs and Genesis dynamic tools in the Codex app-server harness. Tokenjuice hooks Genesis's tool-result middleware and trims the output before it goes back into the active harness session.

Enable the plugin

Fast path:

genesis config set plugins.entries.tokenjuice.enabled true

Equivalent:

genesis plugins enable tokenjuice

Genesis already ships the plugin. There is no separate plugins install or tokenjuice install genesis step.

If you prefer editing config directly:

{
  plugins: {
    entries: {
      tokenjuice: {
        enabled: true,
      },
    },
  },
}

What tokenjuice changes

  • Compacts noisy exec and bash results before they are fed back into the session.
  • Keeps the original command execution untouched.
  • Preserves exact file-content reads and other commands that tokenjuice should leave raw.
  • Stays opt-in: disable the plugin if you want verbatim output everywhere.

Verify it is working

  1. Enable the plugin.
  2. Start a session that can call exec.
  3. Run a noisy command such as git status.
  4. Check that the returned tool result is shorter and more structured than the raw shell output.

Disable the plugin

genesis config set plugins.entries.tokenjuice.enabled false

Or:

genesis plugins disable tokenjuice

Related