ananas-pi

v0.9.0 · for Pi ≥ 1.5.0

The ripe harness for Pi.

ananas-pi turns the Pi coding agent into a ready workbench: 18 curated packages, 19 themes and a few small extensions of our own, picked in one interactive installer. Subagents, memory, LSP checks after every edit, and a pineapple that ripens as your context fills.

curl -fsSL https://pi.ananaslabs.eu/install.sh | bash

Installs Node and Pi if missing (no sudo), keeps your logins and sessions, then opens a checklist.

The hero animation recreates the first-launch intro: a pixel pineapple falls on a starry sky, splashes juice, bounces, shines, and ananas-pi types out. Click it to replay.

17components15 on by default, 2 optional
18curated packagesthird-party, installed by the checklist
19themes10 specials, 8 classics, noctalia default
10own slash commandsplus alt+i and ←← on top
56colour roles per themeevery theme fills all of Pi's roles
16releaseslatest v0.9.0

01 · what you get

Everything wired in.
Nothing to hunt for.

Curated packages and our own extensions, grouped the way you meet them. Each card says which installer component carries it. Third-party ones are other people's work; we pick, patch and wire them.

Rounded input box with a status bar

The status bar lives in the input's border: git branch, folder, live tok/s, context bar, model, tokens and cache hit rate.

/fast-tui
ui · pi-fast-tui

Refined tool cards

Title by the corner, elapsed time on the top border, timeout and exit code on the bottom one, a dotted rule instead of an Output bar.

ctrl+o
ui · fast-tui-cards.mjs

Themed popups

pi-fast-tui drew popups on a black slab. Now they take the theme's surface colour, a rounded border and an accent title.

/model/settings
ui · fast-tui-popup.mjs

Tabbed /settings

Model, Chat, Look, Images, Fullscreen, Startup, Network. ● on / ○ off dots, and typing searches every tab at once.

/settingsTab← →
ui · ananas-settings.ts

19 themes, some of them weird

noctalia by default, 10 specials made for ananas-pi (game-boy, pico-8, synthwave, phosphor…) and 8 classics.

/themes synthwave
themes · agent/themes/*.json

Live theme gallery

Move the cursor and the whole UI re-themes live. Enter keeps it, Esc goes back. b paints the terminal background to match.

/themesb
themes · ananas-themes.ts

Working indicator

A shimmering verb in the input's border, the current action while tools run, live tokens, elapsed time. 7 spinner styles, 4 verb packs.

/shimmer style moon
shimmer · noctalia-shimmer.ts

Thinking peek

A one-line live peek at the model's hidden reasoning while it works.

ui · pi-fast-tui

Subagents in the background

Child agents for review, scouting, audits and saved workflows, running while you keep typing.

/subagents
subagents · pi-subagents

←← fleet inspector

Press ← twice on an empty input: every agent, its model, turns, tokens and live output. ←← again closes. Ignored while another popup has the keyboard.

←←
subagents · fleet-double-left.ts

See what each agent is doing

The line above the input names every running agent with the todo it's on, the tool it's running right now, and its todo progress. No more "1 active agent".

↓
subagents · subagents-focus.mjs

Inspector in a window

Enter on an agent opens its live transcript in a new window of your own terminal (kitty, WezTerm, Ghostty, Alacritty, foot, GNOME Terminal…). Type there to steer it.

EnterH
subagents · subagent-inspector.ts

Todos that stay put

A todo list the model keeps, pinned above the input. It survives /reload and compaction.

/todos
workflow · rpiv-todo

Questions instead of guesses

When the model would guess, it opens a dialog with up to four questions and typed options.

ask_user_question
workflow · rpiv-ask-user-question

Plan mode

Read-only exploration and questions, then an approved plan before a single edit. Implement here or in a fresh session.

/plan
workflow · pi-plan-mode

File checkpoints

/tree and /fork also offer to restore the files Pi edited: undo and redo for the files, not only the chat.

/tree/fork
workflow · pi-checkpoints

Sessions and handoff

Search old sessions, ask them questions, and hand off into a fresh child session with a summary.

/handoff
workflow · pi-sessions

Background processes

A proc tool starts dev servers and watchers that outlive a turn; the agent reads their output or stops them by handle.

proc
workflow · pix-proc

MCP without the bloat

One small proxy tool instead of hundreds of tool definitions; servers are discovered on demand. Replaces Pi's built-in MCP.

mcp
mcp · pi-mcp-adapter

Chrome DevTools (optional)

Browser screenshots, console, network and performance traces for web work. Off by default; needs Chrome or Chromium.

chrome · chrome-devtools-mcp

Web access

Web search, page fetch, GitHub clone, PDF and video reading.

/websearch
web · pi-web-access

LSP and linters after every edit

Language-aware feedback while the agent writes: LSP, linters, formatters and type checks.

/lens-health
code · pi-lens

Hash-anchored edits

Every line the model reads carries a 5-letter anchor. Edits name anchors; stale or ambiguous ones are rejected, never fuzzy-matched.

code · pi-hashline-edit-pro

Edit cards with telemetry

An edit comes back as a card of anchored changed lines, then the answer, then one line: tok/s, time to first token, time, tokens.

ui · pi-fast-tui

Persistent memory

Facts, preferences and corrections survive sessions. It learns from failures, scans for secrets before saving, and searches old sessions.

/memory-insights
memory · pi-hermes-memory

/shake

Folds old tool output, big blocks, images and reasoning out of the model's context. Nothing is deleted; /shake undo restores it.

/shake
tokens · pi-shake

Prompt-cache optimizer

Stable prompts and cache keys, warnings for proxies that break caching, hit rate in the footer.

/cache-optimizer
tokens · pi-cache-optimizer

Context ripeness pip

A pineapple pip by the context bar ripens as it fills: unripe, ripe, overripe. Brown means time to /shake.

/shake
flavor · ananas-flavor.ts

Free models and /usage

Kilo, Cline, LLM7 and OpenCode's free tier, plus quotas and reset times in /usage.

/login kilo/usage
free · pi-free, pi-usage

9router (optional)

Use models from a running 9router: sign in from /login → Sign in with an account.

9router · ananas-9router-login.ts

Screenshot thumbnails

Paste a screenshot and it shows under your message as a thumbnail, and goes to the model with it: no read call.

ctrl+v
images · ananas-images.ts

Full-size image viewer

Every image of the session, yours and tool results. ←/→ step, +/- zoom, o opens it in your viewer. Needs kitty, Ghostty, WezTerm or iTerm2; elsewhere you get a caption.

alt+i/img 3
images · ananas-images.ts

Interactive installer

A checklist, not a monolith. Installs Node and Pi if missing (no sudo), merges settings.json, keeps your logins. Re-run to add or remove parts.

--yes--all--only
install.sh · get.sh

Updates itself

Every launch it checks Codeberg and installs a newer ananas-pi in the background, then asks for /reload. A clone you work in is never touched.

/ananas-update/ananas-update off
update · ananas-update.ts

/ananas-changelog

The whole changelog, scrollable, with your installed release and newer ones marked. Works offline from the local checkout.

/ananas-changelog
update · ananas-update.ts

Its own version number

ananas-pi versions separately from Pi and the welcome shows both. version.json says which Pi it needs.

version.json

First-launch intro

The pineapple falls on a starry sky, splashes juice, bounces and shines; ananas-pi types out. Then a three-step setup: model, thinking level, indicator.

/intro
welcome · ananas-intro.ts

Welcome header

The pineapple grows in pixel by pixel beside a time-of-day greeting, model, folder, recent sessions and a tip.

/welcome off
welcome · ananas-welcome.ts

Seasonal outfits

Santa hat in December, pumpkin in October, sunglasses in summer. Preview any with an environment variable.

ANANAS_SEASON=winter
welcome · ananas-welcome.ts

“green again!”

A test, build or lint that passes after failing earlier gets a sparkle burst above the input.

flavor · ananas-flavor.ts

Receipt on quit

Quit and it prints what the session was: time, turns, tokens, files edited, commands.

/receipt
flavor · ananas-flavor.ts

Pineapple rain

For when you need a moment.

/ananas
flavor · ananas-flavor.ts

Tab title and bell

The terminal title reads 🍍 working or ✓ done; runs longer than 10 seconds ring the bell.

flavor · ananas-flavor.ts

02 · live demos

Poke it.
It runs right here.

Terminal recreations, drawn live from the real spinner, verb, ripeness and palette data in the extensions' sources. Real screenshots are in the gallery.

working indicator · tool cards

It always tells you what it's doing.

A shimmering verb rides the input's top border, swaps to the current action while tools run, and counts tokens and seconds. Tool cards get the time on top and the exit code at the bottom.

  • Pick one of the real spinner styles and verb packs.
  • Edits come back with hash anchors on every changed line.
/shimmer style star · /shimmer verbs ananas

subagents · ←← inspector

A fleet, one keypress away.

Subagents run in the background while you keep working. Press ← twice on an empty input and the inspector opens: every agent, its model, turns, tokens and live output. ←← again closes it.

  • Todos stay pinned above the input and survive compaction.
  • It ignores ←← while another popup or viewer has the keyboard.
or focus the terminal and press ← twice
pi · ~/demo-game · recreation

ananas flavor

The pineapple ripens as you work.

The pip by the context bar goes from unripe to ripe to overripe as context fills. Brown means /shake. A test that finally passes gets a burst, and quitting prints a receipt.

images · alt+i

Paste a screenshot. See it. Zoom it.

A pasted screenshot shows as a thumbnail under your message and goes to the model with it. alt+i or /img opens a full-size viewer over every image of the session, including tool results.

  • ←/→ step, +/- zoom, o opens it in your system viewer, Esc closes.
  • Inline images need kitty, Ghostty, WezTerm or iTerm2; elsewhere it's a caption.
pi · ~/demo-game · recreation

04 · themes

19 themes.
Try one on.

The mock terminal uses each theme's real colour roles from agent/themes. Use ↑ ↓ on the list like in /themes: it previews as you move.

Default

Special

Classic

noctaliadefault · special

the ananas-pi default: neon violet and pink at night

/themes noctalia

05 · components

A checklist,
not a monolith.

Tick what you want; the install line below rebuilds itself. Adding a component is one JSON entry in components.json.

17 components · 15 on by default · 2 optional · 18 third-party packages
ComponentWhat it doesPackages · own filesDefault
status bar in the box border, refined tool cards, themed rounded popups (pi-fast-tui)pi-fast-tuiananas-settings.tsfast-tui-popup.mjsfast-tui-cards.mjson
pineapple intro and setup on first launch, animated welcome header; /intro, /welcomeananas-welcome.tsananas-intro.tson
pasted screenshots show as thumbnails and reach the model; alt+i or /img opens a full-size viewerananas-images.tson
18 themes: specials (ananas, game-boy, pico-8, synthwave, phosphor, …) and classics; /themes gallery with live previewananas-themes.tson
animated Noctalia shimmer with live tokens, elapsed time, current actionnoctalia-shimmer.tson
ripeness meter, kitty tab title + bell, green-again burst, session receipt, /ananasananas-flavor.tson
child agents, background runs, fleet line with each agent's name, current todo and tool, ←← fleet inspector, Enter opens a live inspector window in any terminalpi-subagentsfleet-double-left.tssubagent-inspector.tssubagents-focus.mjson
todo list, structured questions, /plan mode, file checkpoints, /handoff, background processes@juicesharp/rpiv-todo@juicesharp/rpiv-ask-user-question@narumitw/pi-plan-modepi-checkpointspi-sessions@xynogen/pix-procon
LSP diagnostics and linters after every edit, hash-anchored edits (pi-lens, pi-hashline-edit-pro)pi-lenspi-hashline-edit-proon
web search, page fetch, GitHub clone, PDF and video readingpi-web-accesson
persistent memory and past-session search (pi-hermes-memory)pi-hermes-memoryon
prompt-cache optimizer, /shakepi-cache-optimizerpi-shakeon
MCP adapter (replaces Pi's built-in MCP)pi-mcp-adapteron
Kilo, Cline, LLM7, OpenCode free tier; provider quotas and reset timespi-free@narumitw/pi-usageon
models from a 9router instance, connect in /login (needs a running 9router)pi-9router-extananas-9router-login.tsoptional
updates ananas-pi and its packages on startup (/ananas-update off to only get a notice)ananas-update.tson
browser screenshots, console, network, performance (needs Chrome/Chromium, MCP servers)config onlyoptional
15 selected: the defaults. The plain line opens this checklist for you.
curl -fsSL https://pi.ananaslabs.eu/install.sh | bash

06 · lately

Still ripening.
Latest releases.

v0.9.0latest

  • See what your subagents are doing: the line above the input names each running agent with the todo it has in progress, the tool it runs right now, and its todo progress (● site-builder · ◐ porting the hero · ▸ bash npm run build · todo 3/7). The roster (↓) shows the same per agent.
  • Enter (or H) on an agent in the fleet opens its live inspector in a new window of your terminal: kitty, WezTerm, Ghostty, Alacritty, foot, GNOME Terminal, Konsole, xterm, macOS Terminal or iTerm2. It used to say "No inspector plugin is available" outside tmux and Herdr. Type in that window to steer the agent.
  • Shorter install line: curl -fsSL https://pi.ananaslabs.eu/install.sh | bash.
  • New website, built with Astro, in site/.

v0.8.3

  • ←← opens the subagent fleet only from the empty main input. It no longer fires inside the image viewer, /ananas-changelog, /settings, or any other popup or dialog.

v0.8.2

  • /ananas-changelog shows the whole changelog in a scrollable view: the latest from Codeberg, or the local checkout when offline. Your installed release and newer ones are marked.

v0.8.1

  • Fixes the 0.8.0 install stopping at "syncing packages" with Cannot find module …/fast-tui-popup.mjs patches/fast-tui-cards.mjs: the installer ran a component's two patch scripts as one path. Updating finishes the install that 0.8.0 left half done.

v0.8.0

  • Pasted screenshots are visible: a thumbnail under your message (name, size, attached). They are attached to the message when the model takes images, so it sees them without a read call.
  • alt+i or /img opens a full-size image viewer: ←/→ through every image of the session, including tool results, +/- zoom, o opens it in the system viewer.
  • Tool cards look cleaner: the title sits by the corner, time is on the right of the top border, timeout and exit code are on the right of the bottom one, a dotted rule replaces the Output bar, and a wrapped command is indented. Updating applies it.

v0.7.1

  • pi-tuck is dropped from Token saving, and updating removes it from existing installs. After its first compaction it broke Claude requests (input_schema.type: Field required), and it aborts any session /shake has edited (pi-tuck does not support replacement context edits). Compaction falls back to Pi's built-in one.

10 earlier releases are in CHANGELOG.md, or run /ananas-changelog in Pi.

07 · install

One line.
Then it keeps itself fresh.

  1. Run the lineIt installs Node and Pi when they're missing, into your home directory, no sudo.
  2. Tick your parts↑/↓, space, enter. Re-run any time to add or remove components.
  3. Launch piThe intro plays once, then three questions: model, thinking level, indicator.
  4. Forget itEvery launch checks Codeberg; a newer ananas-pi installs in the background.
curl -fsSL https://pi.ananaslabs.eu/install.sh | bash

Needs curl, tar and jq; Node and Pi are fetched if missing. Linux and macOS, x64 or arm64.

--yesNo questions: defaults on a first run, your current selection on a re-run.
--allEverything, including the optional components.
--only ui,webExactly these components. --list shows the ids.
bash -s --With curl, pass flags after it. Without a terminal the installer uses --yes.

If this site is ever down, the same script comes straight from Codeberg: curl -fsSL https://codeberg.org/AnanasCharles/ananas-pi/raw/branch/main/get.sh | bash

Questions

Is this a fork of Pi?

No. It's a harness around Pi: curated packages, a few extensions, patches for pi-fast-tui and themes, plus the installer. Pi itself stays Pi and updates with pi update. ananas-pi needs Pi ≥ 1.5.0 (last tested with v1.5.2).

What does it change on my machine?

It adds Node to ~/.local/share/pi-node only if yours is too old, installs Pi if missing, and merges into ~/.pi/agent/settings.json: logins, model choices and packages you added yourself stay. Extensions that fail to load are moved to extensions.disabled/, nothing is deleted.

Does it update itself?

Yes, on every launch, in the background. /ananas-update off only shows a banner instead. A git clone you work in is never touched; the banner tells you to git pull && ./install.sh --yes.

Which terminals work?

Any terminal runs it. Inline screenshots need the kitty or iTerm2 image protocol (kitty, Ghostty, WezTerm, iTerm2); elsewhere you get a caption. Painting the background to match a theme works in kitty, WezTerm, foot, Ghostty, iTerm2 and most others.

Which models can I use?

Whatever Pi supports: /login as usual. Free options are in the box (/login kilo, /login cline, LLM7 without an account), and a 9router instance can be added as an optional component.

How do I install from a clone?

git clone https://codeberg.org/AnanasCharles/ananas-pi.git && cd ananas-pi && ./install.sh