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-tuiv0.9.0 · for Pi ≥ 1.5.0
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 | bashInstalls 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.
01 · what you get
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.
The status bar lives in the input's border: git branch, folder, live tok/s, context bar, model, tokens and cache hit rate.
/fast-tuiTitle 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+opi-fast-tui drew popups on a black slab. Now they take the theme's surface colour, a rounded border and an accent title.
/model/settingsModel, Chat, Look, Images, Fullscreen, Startup, Network. ● on / ○ off dots, and typing searches every tab at once.
/settingsTab← →noctalia by default, 10 specials made for ananas-pi (game-boy, pico-8, synthwave, phosphor…) and 8 classics.
/themes synthwaveMove the cursor and the whole UI re-themes live. Enter keeps it, Esc goes back. b paints the terminal background to match.
/themesbA 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 moonA one-line live peek at the model's hidden reasoning while it works.
Child agents for review, scouting, audits and saved workflows, running while you keep typing.
/subagentsPress ← twice on an empty input: every agent, its model, turns, tokens and live output. ←← again closes. Ignored while another popup has the keyboard.
←←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".
↓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.
EnterHA todo list the model keeps, pinned above the input. It survives /reload and compaction.
/todosWhen the model would guess, it opens a dialog with up to four questions and typed options.
ask_user_questionRead-only exploration and questions, then an approved plan before a single edit. Implement here or in a fresh session.
/plan/tree and /fork also offer to restore the files Pi edited: undo and redo for the files, not only the chat.
/tree/forkSearch old sessions, ask them questions, and hand off into a fresh child session with a summary.
/handoffA proc tool starts dev servers and watchers that outlive a turn; the agent reads their output or stops them by handle.
procOne small proxy tool instead of hundreds of tool definitions; servers are discovered on demand. Replaces Pi's built-in MCP.
mcpBrowser screenshots, console, network and performance traces for web work. Off by default; needs Chrome or Chromium.
Web search, page fetch, GitHub clone, PDF and video reading.
/websearchLanguage-aware feedback while the agent writes: LSP, linters, formatters and type checks.
/lens-healthEvery line the model reads carries a 5-letter anchor. Edits name anchors; stale or ambiguous ones are rejected, never fuzzy-matched.
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.
Facts, preferences and corrections survive sessions. It learns from failures, scans for secrets before saving, and searches old sessions.
/memory-insightsFolds old tool output, big blocks, images and reasoning out of the model's context. Nothing is deleted; /shake undo restores it.
/shakeStable prompts and cache keys, warnings for proxies that break caching, hit rate in the footer.
/cache-optimizerA pineapple pip by the context bar ripens as it fills: unripe, ripe, overripe. Brown means time to /shake.
/shakeKilo, Cline, LLM7 and OpenCode's free tier, plus quotas and reset times in /usage.
/login kilo/usageUse models from a running 9router: sign in from /login → Sign in with an account.
Paste a screenshot and it shows under your message as a thumbnail, and goes to the model with it: no read call.
ctrl+vEvery 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 3A 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--onlyEvery 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 offThe whole changelog, scrollable, with your installed release and newer ones marked. Works offline from the local checkout.
/ananas-changelogananas-pi versions separately from Pi and the welcome shows both. version.json says which Pi it needs.
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.
/introThe pineapple grows in pixel by pixel beside a time-of-day greeting, model, folder, recent sessions and a tip.
/welcome offSanta hat in December, pumpkin in October, sunglasses in summer. Preview any with an environment variable.
ANANAS_SEASON=winterA test, build or lint that passes after failing earlier gets a sparkle burst above the input.
Quit and it prints what the session was: time, turns, tokens, files edited, commands.
/receiptFor when you need a moment.
/ananasThe terminal title reads 🍍 working or ✓ done; runs longer than 10 seconds ring the bell.
02 · live demos
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
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.
star · /shimmer verbs ananassubagents · ←← inspector
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.
ananas flavor
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
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.
03 · the real thing
Screenshots from real sessions with the Noctalia palette and a Nerd Font; your terminal decides the exact look.
/intro replays it.04 · themes
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
ripen() in src/fruit.ts05 · components
Tick what you want; the install line below rebuilds itself. Adding a component is one JSON entry in components.json.
| Component | What it does | Packages · own files | Default |
|---|---|---|---|
| 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.mjs | on | |
| pineapple intro and setup on first launch, animated welcome header; /intro, /welcome | ananas-welcome.tsananas-intro.ts | on | |
| pasted screenshots show as thumbnails and reach the model; alt+i or /img opens a full-size viewer | ananas-images.ts | on | |
| 18 themes: specials (ananas, game-boy, pico-8, synthwave, phosphor, …) and classics; /themes gallery with live preview | ananas-themes.ts | on | |
| animated Noctalia shimmer with live tokens, elapsed time, current action | noctalia-shimmer.ts | on | |
| ripeness meter, kitty tab title + bell, green-again burst, session receipt, /ananas | ananas-flavor.ts | on | |
| 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 terminal | pi-subagentsfleet-double-left.tssubagent-inspector.tssubagents-focus.mjs | on | |
| 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-proc | on | |
| LSP diagnostics and linters after every edit, hash-anchored edits (pi-lens, pi-hashline-edit-pro) | pi-lenspi-hashline-edit-pro | on | |
| web search, page fetch, GitHub clone, PDF and video reading | pi-web-access | on | |
| persistent memory and past-session search (pi-hermes-memory) | pi-hermes-memory | on | |
| prompt-cache optimizer, /shake | pi-cache-optimizerpi-shake | on | |
| MCP adapter (replaces Pi's built-in MCP) | pi-mcp-adapter | on | |
| Kilo, Cline, LLM7, OpenCode free tier; provider quotas and reset times | pi-free@narumitw/pi-usage | on | |
| models from a 9router instance, connect in /login (needs a running 9router) | pi-9router-extananas-9router-login.ts | optional | |
| updates ananas-pi and its packages on startup (/ananas-update off to only get a notice) | ananas-update.ts | on | |
| browser screenshots, console, network, performance (needs Chrome/Chromium, MCP servers) | config only | optional |
curl -fsSL https://pi.ananaslabs.eu/install.sh | bash06 · lately
● site-builder · ◐ porting the hero · ▸ bash npm run build · todo 3/7). The roster (↓) shows the same per agent.curl -fsSL https://pi.ananaslabs.eu/install.sh | bash.site/./ananas-changelog, /settings, or any other popup or dialog./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.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.attached). They are attached to the message when the model takes images, so it sees them without a read call./img opens a full-size image viewer: ←/→ through every image of the session, including tool results, +/- zoom, o opens it in the system viewer.Output bar, and a wrapped command is indented. Updating applies it.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
piThe intro plays once, then three questions: model, thinking level, indicator.curl -fsSL https://pi.ananaslabs.eu/install.sh | bashNeeds 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
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).
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.
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.
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.
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.
git clone https://codeberg.org/AnanasCharles/ananas-pi.git && cd ananas-pi && ./install.sh