AnimaOS : The Autonomous Agent is the Operating System

A revolutionary Proof of Concept (PoC) for Hackathons built with Nuxt 3 / Nitro, WebSockets, and Unstorage Persistence, powered by the ultra-fast Bun runtime.

The Problem: The Black Box of Chat Agents

Today, the user experience with AI agents (such as Co Work, Google Spark, OpenClaw, etc.) suffers from a major flaw: a complete lack of observability. To understand what the agent is doing, the user has to:

• Read long, winding streams of text describing the agent's reasoning.
• Go through dense text summaries.
• Analyze complex console logs that are unreadable to non-developers.

There is an enormous cognitive workload just to answer the simple question: "What is my agent doing right now?"

The AnimaOS Solution: Observability Built into the UI

AnimaOS reverses this paradigm: The Agent is the Operating System.

Every single internal operation of the agent (reasoning, navigating, calculating, communicating) is transcribed graphically and physically on the screen in real-time via a bi-directional WebSocket channel:

• If the agent wants to read a document, the agent's virtual cursor glides over to the Finder, double-clicks the file, and the Notes editor opens.
• If the agent wants to calculate a budget, it opens Sheet, types the formula, and you see the cells fill up before your eyes.
• If the agent sends an email, you see the composition window fill up at human-like typing speed before being sent.

This is a brand new way to observe, trust, and collaborate with artificial intelligence.

Minimalism & Pre-Built Context (Agent-Centric OS)

Traditional operating systems are far too complex and dense with useless data for LLMs. AnimaOS reinvents the OS from a minimalist and agent-optimized perspective:

1. Simplified File Abstraction: Shell commands are short, atomic, and direct (sheet open, notes write, email send).
2. Dynamic Context Assembly: The instruction prompt sent to the agent is compiled dynamically based on the current state of the OS (which apps are open, which window has focus, which file is active).
3. 10-Word Metadata Add-on System: To prevent the agent from getting lost in large files or consuming excessive tokens, every file (CSV, Image, Audio) includes a metadata add-on containing a strict 10-word maximum summary. The agent accesses the core essence of the file instantly!
4. Mascot & Persistent Persona: AnimaOS features Animy, an agent with an endearing, slightly stubborn, and transparent personality. Its historical thought stream accumulates dynamically to refine its behavior over the course of the session.

Quick Start with Bun

AnimaOS uses Bun as its runtime and package manager for instant responsiveness during your hackathon pitch.

1. Install dependencies

bun install

2. Run the development server

bun run dev

3. Build for production

bun run build

Going Further...

Explore the complete specifications and behavior of AnimaOS:

• AGENTS.md: Under the hood of the agent, the observation loop, and the 10-word summary system.
• GEMINI.md: The persona of Animy, the mascot, LLM system instructions, and dynamic user history context files.
• anima_shell_spec.md: The exhaustive list of mini-shell commands accepted by the OS.