') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - maxwraae/aria · GitHub
Skip to content
BranchesTags

Repository files navigation

Aria

Adaptive Recursive Intelligent Actions

You give it an objective, any desired state that should be true but isn't yet, and it produces actions to make it true. That's what the system does. It acts. Intelligent actions, because each one is chosen with judgment, the highest-value move given what you know right now. Recursive, because every action's output becomes the next cycle's input, a loop that keeps turning until the objective is true. Adaptive, because the system learns across those cycles, updating its understanding from what came back, adjusting as reality teaches it what works.

Objectives live in a tree. At the top sits one that never resolves: help Max thrive and succeed. Below that, objectives get progressively more concrete until they're actionable enough for an agent to pick up and do. Each objective has an inbox. Messages arrive, an agent wakes up, observes, analyzes, acts, and exits. New messages wake it again. The cycle repeats until the desired state is true.

The loop

Every objective runs the same cycle. Observe: read new messages, check what children reported, understand the current state. Analyze: connect what you just observed to what you already know, ask whether you have the knowledge to act. Act: do whatever the analysis pointed to, then exit. The agent doesn't persist between cycles, but conversation history does, so context accumulates. The agent who wins has the fastest cycle.

Structure

Aria/
├── engine/ TypeScript server, CLI, and agent engine
│ └── src/
│ ├── cli/ CLI commands (aria tree, aria create, aria send, ...)
│ ├── context/ Prompt assembly: modular "bricks" that build agent context
│ ├── db/ SQLite schema, queries, migrations
│ ├── engine/ The loop: polling, spawning agents, processing output
│ ├── memory/ Memory extraction from conversations
│ └── server/ HTTP API, WebSocket, static file serving
│
├── surface/ React frontend (Vite)
│ └── src/
│ ├── components/ UI: chat cards, input bar, objective cards, breadcrumbs
│ ├── hooks/ API client, WebSocket connection, audio
│ ├── constants/ Theme and styling
│ └── context/ React context (focused objective state)
│
└── data/ SQLite databases (synced via iCloud)
├── macbook.db Objectives database for MacBook
├── mini.db Objectives database for Mac Mini
└── memories.db Extracted memories from agent conversations

Running

Development (watch mode, hot reload):

cd engine && npm run dev # Engine with file watchingcd surface && npm run dev # Vite dev server on :5173

Production:

aria up # Engine + built surface on :8080

Or manually:

cd engine && npm run build && npm start

CLI

aria tree # Show the full objective tree
aria show <id># Inspect one objective
aria inbox <id># Read an objective's conversation
aria find "query"# Search objectives
aria create "desired state""instructions"# Create a child objective
aria send <id>"message"# Send a message to an objective
aria succeed <id>"summary"# Resolve a child
aria fail <id>"reason"# Mark a child as failed
aria reject <id>"feedback"# Send back for another attempt

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages