Petal for macOS
A terminal for Claude Code, with a reader for its replies and a cat who keeps you company.
Claude writes careful replies. Petal gives each one a page.
Get started
Six steps. About five minutes.
Install Claude Code.
curl -fsSL https://claude.ai/install.sh | bashOr
brew install --cask claude-code.Check
claude --versionprints a version.Download Petal and drag it to Applications.
Open Petal.
Click Add Session, then type
claudeand press Enter.First time only: pick how to sign in. Your browser opens. Sign in with your Claude account.
Check the terminal says you are logged in.
Ask Claude something. The reply lays out above. Your cat wakes when it is done.
Reader empty? Make sure claude is running in the tab, and that your Claude plan includes Claude Code (Pro, Max, Team or Enterprise).
What a reply looks like
Real pieces of Petal's reader. Click them.
The build is slow because it type-checks twice
Abstract. A clean build takes 94 seconds. 58 of them are a second check. Drop it and the build takes 38.
- Doing
- nothing running
- Recommend
- drop the second check
- Next
- I open a small change
Steps
- Remove the bundler's check
- Keep
tsc --noEmitfirst - Time one clean build
Type-check 31s. Second check 58s. Transpile 5s.
The plugin came first. Nobody removed it.
ShipShip the change today?
- Conclusion
- The second type-check goes.
- Result
- 94s down to 38s.
- Impact
- Every build, every day.
DecideShip today, or wait for review?
Watch outWatch mode stops printing type errors.
export default {
plugins: [typecheck()],
}Everything in it
Reading
- Sections that fold
- Steps you can tick
- Highlights with a colour key
- Question cards
- Paste or drop images
- Conclusion banners
Sessions
- Tabs for each session
- History of past sessions
- Favorites with stars
- Notes per session
- Live Agents timeline
- Flow and Decisions views
Customisation
- 4 reply styles, set in Customize
- 4 reading looks
- 3 themes
- 5 pets, in 3 sizes
- 12 scenes
- A shape guide
Calm
- Low CPU when idle
- The real Claude Code
- Nothing proxied
How it works
- You type in the terminal
- Claude Code runs, unchanged
- It writes a session log
- Petal reads the log
- Each reply gets a page
A cat who keeps you company
She dozes while Claude works. She wakes when it is done.