SugarCrush — SugarCraft

🤖 SugarCrush

AI coding-assistant chat shell

port of crush ai chat anthropic openai ollama

Chat-shell TUI for AI coding assistants. Pluggable backends (ship your own Anthropic / OpenAI / Ollama / shell-out adapter), Markdown rendering of replies via CandyShine, scrollback above a fixed input box.

Install

composer require sugarcraft/sugar-crush

Quickstart

composer install
./bin/sugarcrush

# By default it ships with EchoBackend (offline). Wire to a real LLM:
export SUGARCRUSH_BACKEND_CMD=~/bin/anthropic-stream.sh
./bin/sugarcrush

# ~/bin/anthropic-stream.sh
#!/usr/bin/env bash
payload=$(jq -nc --argjson h "$(cat)" \
  '{model: "claude-opus-4-7", max_tokens: 4096, messages: $h}')

curl -sN https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "$payload" \
  | jq -r '.content[0].text'

What's in the box

Pluggable BackendImplement Backend::send(History): string. EchoBackend ships for offline runs.

CommandBackendShell out to $SUGARCRUSH_BACKEND_CMD — hand it JSON history, read its stdout.

Markdown reply renderingAssistant replies pass through CandyShine — code blocks, lists, links all rendered.

Scrollback + fixed inputTop region scrolls, input box stays glued to the bottom.

History persistenceEvery turn is appended to a JSONL file you can grep / replay.

Network-dep-freeWrapping curl / your provider SDK in a wrapper script keeps the PHP package import-light.

Source & demos

Try the quickstart →

Key Classes

Class	Method	Description
Backend	send(history)	Send messages to LLM
EchoBackend	new()	Offline echo backend
CommandBackend	new(command)	Shell out to external command
History	add(role, content)	Add message to history
Chat	new(backend)	Create chat model
Chat	update(msg)	Handle chat message