raea 0.1.4

raea 0.1.4 is the speed release: views, cards and playback come up faster, and raea's window keeps up with a busy timeline. It also brings a timeline you edit by hand the way CapCut works, agents with faces of their own, a plan for every project that you and your agents keep together, a Source page for everything a project is made of, a Get Started project that teaches raea down its feed, and a clear view of what raea keeps on your disk.

Get the app at raea.io (a Mac with Apple silicon, Windows 10 or 11, or Linux on x86_64).

The engine alone:

curl -fsSL https://raea.io/install | sh

On Windows, in PowerShell: irm https://raea.io/install.ps1 | iex.

What changed since 0.1.3

Faster where you wait.

• A view opens at once the first time. Source, the editors, Plugins and the rest used to pause about 300 ms on their first open.
• A raea show from your terminal is a card in the feed within a second (0.12 to 0.83 s, down from 0.85 to 1.83 s).
• The app no longer starts two processes to find a project's folder on each request, so a page full of thumbnails stops queueing behind itself.
• Playback is smoother: with two 1080p60 videos side by side, the worst wait between frames each second averages 24 to 26 ms, down from 29 to 31. A film playing with its timeline open no longer redraws the whole watch view on every tick.
• In raea's window, changing an element restyles only what the change touches, so dragging a clip on a 400-clip timeline runs at 48 to 50 frames a second, up from 38 to 41.
• A ray-traced shot's first frame waits less for its models (744 ms down to 529 to 632 ms on a 61-frame shot). Drafts are drawn smaller than they ship and laid out as they ship, which makes a ray-traced draft about 1.7 times faster.
• Library tiles show a picture before the file is indexed, instead of the word IMAGE.

A timeline you edit by hand. Watch, Listen and a scene's view have a CapCut-style timeline under the picture. Trim, split and move clips, change a clip's speed or draw a speed curve, freeze a frame, play footage backward, set keys and shape their curves, and copy a clip's attributes onto others. Put a mask, a blend or a chroma key on a clip with handles on the picture, and use Adjust's sliders. Add In, Out and Combo animations, transitions, effects and styled text. You can also:

• make captions from what is said, and have a text read aloud;
• record a voice-over at the playhead;
• hold shaky footage steady;
• cut a subject out automatically or by brushing over it (Apple's Vision, on your Mac);
• retouch faces;
• reduce a sound's noise or change its voice.

Every edit is written into the composition's own code, and Send hands what you changed to your agent. Plugins can add effects, text styles, tools, snap grids and kinds of track. The same model is in the SDK as raea/editor.

Getting around it works the way editors do:

• The wheel moves through time and down the tracks, and ⌘ or a pinch zooms about the pointer without zooming the page.
• A zoom bar under the tracks shows the whole film and the part in view: drag it to scroll, drag its ends to zoom, double-click to fit.
• The playhead stays in view as it plays and after a jump.
• The top edge resizes the panel, and resizing is never an undo step. Collapsed, the timeline is one row with a scrubber.
• Many tracks scroll in a height of their own, with their names beside them.
• The volume is a slider that stands up over the speaker, so the speaker never moves under your click.

Agents with faces. The Agents pane sits at the bottom of the sidebar, folded until you need it. Each agent is a small object rendered by raea, in one of five shapes and sixteen materials (jade, copper, obsidian, marble, velvet, pearl and more), with dark pill eyes that follow your pointer and show what it's doing: thinking, working, waiting, needing you or done. You name your AI when you set it up, and you right-click an agent to make it your primary AI or archive it. An avatar SDK lets you draw faces of your own.

Get Started. A new studio's only project is Get Started, and setup ends on it. It's a lesson you follow down its feed:

1. how raea works;
2. a video made from code;
3. a game;
4. a 3D scene;
5. a small app;
6. making your own.

Each card points at its own file, so you can change it, and a note on one goes to your AI with the file.

A plan for every project. A project's to-do list is now one file at the top of its folder, plan.org, in Org mode. Your agents keep it as they work: they plan anything with more than one step there, mark what they're making and what waits on you, close each task with what it made, and add what's left. A message you send becomes a task for the agent it went to. You can edit the file in Emacs or any editor, and the list picks the change up. Builders get the same plan as typed tasks in @raea/task, with keywords, properties, kinds and views a plugin can add, and React hooks and components.

Source is one page. A project's compositions, components, files and apps sit together as cards, with search and a filter. Click one to inspect it beside the list: its picture, facts, versions, renders, what it uses and what uses it. Add files with Add files or by dropping them anywhere on the page, from the Finder too. What raea's scan finds loose waits quietly behind Tidy instead of a red bar. Controllers keep their own tab.

The Library searches everything. Search reaches every project's compositions, components, files and artifacts as you type, and your libraries by what's in each picture, video and sound. A hit opens its project's Source with the thing already picked. Storage and People on projects sit in the Library too, beside review links and what's shared with you.

See what raea keeps on your disk. Settings → Storage lists each project's files and where they live. It has Sync now, a breakdown of what raea keeps on this Mac, and Old and unused, which checks again before it moves anything. Footage added in Source is copied in without doubling the space it takes. Your agent gets the same tools (storage_status, storage_plan, storage_trash, footage_add) and a guide for old video.

Controls that feel like hardware. Switches, selectors and keys are drawn as dark hardware and click on raea's own mixer, since a page in raea's window can play sound now. Every page's tabs share one look.

Chats and the feed.

• What an agent reads, looks at or posts (a sheet, a still, a frame) shows as pictures in the chat. Click one to see it over the whole window: zoom, pan, step through them, and pin a comment on a spot, which goes to the agent with the file and where on it you mean.
• Copy reference on anything's right-click menu copies a line naming it by id (the item, its project and its workspace) to paste to an agent, so it acts on exactly that thing.
• Agents name projects by id rather than title, and raea show --project takes one, so their posts stop landing in the wrong project. Before making anything, they settle which workspace and project the work is for and go there.
• Stopping an agent reads as stopped, everywhere you can stop it.
• A chat's header shows that chat's own state, and its project's name takes you to the project's feed.
• What a chat posted opens over its feed, with Back to the chat.
• The chat beside each feed stays where you left it.
• A Claude Code session started in a terminal opens as a chat beside its feed, with where it came from on an icon in the chat's header. What it posts while it runs shows under its card in the feed.
• A chat whose agent crashed starts it again when you write.
• raea's own agents no longer show up twice in the feed.
• An empty project's feed points you at its to-do list.
• An agent's question is a plain form with no editing toolbar.

Workspaces. Give a workspace an icon of your own from the whole Solar icon set (about 1,400, searchable), from its menu's Change icon.

Setting up. Onboarding chooses nothing for you: no AI is connected or picked until you pick it, and a message you send before then waits for Pick an AI. A downloaded app starts with no sample workspace. A workspace you name goes in /Documents/raea (/raea when Documents is in iCloud), and the Welcome screen got a stage of its own. Opening raea again goes straight into the app, with what finished while you were away at the top of the Inbox, instead of a Welcome back card.

More ways to make pictures and clips. Setup's Images and video step, and Plugins, offer a made.app key, an OpenRouter sign-in in your browser, or a fal key, besides ChatGPT. made.app's sign-in is gone: it couldn't give raea a key, so it now takes a pasted one. Without a made.app key, raea gen makes pictures with fal's Nano Banana 2, or else OpenRouter's Gemini image model, so either account works on its own.

Signing in.

• Kimi signs you in where your account is, kimi.ai or kimi.com, instead of always the same one.
• A signed-out Claude says so and offers its sign-in.
• When the keychain won't keep raea's sign-in, raea says so at once.
• Continue on raea.io tries a dropped connection again and says why when it can't get through.
• raea now uses the proxy set in your Mac's network settings, as your browser does.
• A Mac that finished setting up through raea.io opens into the app even when raea.io can't be reached.

For builders.

• raea skills install --agent grokbot stages raea's skill for Grok Bot and prints Grok Bot's own links to finish it.
• A package in your project's node_modules that imports raea shares the composition's SDK instead of failing with "Can't find variable: raea". Thanks @Ragulsundaram (#151).
• An error thrown inside <R3F> fails the render with its message instead of drawing nothing, and three's PMREMGenerator works there. Thanks @Ragulsundaram (#131).
• <Composition edit={{ scale }}> draws a draft at a fraction of its size.
• New SDK pieces for edits as code: <Transition>, <Effect>, speedCurve, <Nudge keys>, masks and keys, and a <Video> matte.
• Text with an ellipsis is cut only when it doesn't fit.

Fixes

• The feed and Inbox badges count only what the feed shows. They used to count posts from a terminal session that the feed never drew, and things you'd hidden or muted.
• Signed in on raea.io without GitHub, your account's picture no longer asks GitHub for one with your email in its address, and Settings → Account names your email instead of saying you signed in with GitHub.
• Agents' faces at rest no longer redraw every frame, so they stop slowing the window.
• One item the feed can't read no longer blanks the whole Inbox: it's left out, and a card that fails to draw shows a line in its place.
• Comments written after a reload no longer reuse ids from before it.
• Back and forward go back and forward, and a reload lands where you were.
• Open login, Open page and Discord's Join open in raea's window, and say so when a page didn't open.
• raea never commits a render's frames or a half-written file.
• TikTok, X and the other one-colour marks in Publish and Plugins are light on dark in raea's window, not black.
• An SVG coloured by a class (a timeline curve's handles, a chart's labels) draws in its colour in raea's window, not black.

Known

• The Windows app is unsigned, as before: Windows asks once whether to run it.
• A proxy set by an automatic configuration (PAC) file isn't read. If yours uses one, start raea with HTTPS_PROXY set.
• Drawn characters (the Character SDK) come in 0.1.5.