Multi-Agent Collaboration for Team and Friends
TypeScript agent-automationagent-orchestrationagent-workflowai-agentsai-collaborationai-memoryai-workforceautonomous-agentsclaude-codeclaude-code-skillscodexcoding-agentmulti-agentmultiple-agentone-person-businessone-person-companyone-person-teamopencodesolopreneur
feat(app): add sidebar tooltips, polish README, fix CLI project root
Gusc86c15409cf2
diff --git a/README.md b/README.mdindex 53ca5f51f..591f55017 100644--- a/README.md+++ b/README.md@@ -1,81 +1,75 @@<p align="center">- <img src="./assets/readme-banner.png" alt="Alook – Your Personal Company" width="800" />+ <img src="./assets/readme-banner.png" alt="Alook – Open-source platform to run your personal AI company" width="800" /></p><p align="center">+ <a href="https://github.com/alookai/alook"><img src="https://img.shields.io/github/stars/alookai/alook?style=social" alt="GitHub Stars" /></a><a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License" /></a><a href="https://github.com/alookai/alook/actions"><img src="https://github.com/alookai/alook/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>+ <a href="https://www.npmjs.com/package/@alook/app"><img src="https://img.shields.io/npm/v/@alook/app.svg" alt="npm version" /></a><a href="https://discord.alook.ai"><img src="https://img.shields.io/badge/Discord-Join%20us-5865F2?logo=discord&logoColor=white" alt="Discord" /></a></p>+<p align="center">+ <a href="https://alook.ai">Website</a> · <a href="https://alook.ai/templates">Templates</a> · <a href="https://discord.alook.ai">Discord</a>+</p>## What is Alook?-Alook is the collaboration layer for your Al workforce. Give agents email addresses, assign them roles — dev, ops, research — and let them collaborate like a real team.+Alook is an open-source, self-hosted platform that turns your local AI coding agents into a collaborative workforce. Give agents email addresses, assign them roles — dev, ops, research — and let them collaborate like a real team.Agents run on your machine with full access to your tools and codebase. Alook connects them to email, dashboards, calendars, and the outside world.You're the CEO. Define the org chart. Your company runs 24/7.<p align="center">- <img src="./assets/alook-org_rounded.png" alt="Alook Org Chart" width="700" />+ <img src="./assets/alook-org_rounded.png" alt="Alook Org Chart — visual agent collaboration canvas" width="700" /></p>-## Quick Start-**Local**-```bashnpx @alook/app onboard```-The onboard command walks you through setup — connecting your machine, detecting runtimes, and deploying your first agent company.+This walks you through setup — connecting your machine, detecting runtimes, and deploying your first agent company. Open `http://localhost:3000` when it's done.-**Global**+Or go to [alook.ai](https://alook.ai) and claim unique `@alook.ai` email addresses for your agents.-Go to alook.ai, and claim unique `@alook.ai` email for your agents.+## Features-## Features--- **Collaboration** — Define roles, build your org chart. Agents coordinate automatically.+| Feature | What it does |+|---------|-------------|+| **Collaboration** | Define roles, build your org chart. Agents coordinate automatically. |+| **Email-native** | Each agent gets its own email. Human-to-agent, agent-to-agent — all in one place. |+| **Kanban** | Assign tasks, track progress. Agents pick up work, update status, and close issues autonomously. |+| **Calendar** | Agents manage their own schedule — recurring tasks, reminders, daily routines. |+| **Local-first & Always-on** | Agents run on your machine. Your codebase never leaves, but reach them from anywhere. |+| **Self-learning** | Every completed task builds context. Agents remember decisions, learn preferences, and get sharper. |+| **Traceable** | Every instruction, decision, and reply is recorded. Full accountability, no black boxes. |<p align="center">- <img src="./assets/alook-collaboration_rounded.png" alt="Alook Collaboration" width="500" />+ <img src="./assets/alook-collaboration_rounded.png" alt="Alook agent collaboration graph" width="500" /></p>---- **Email-native** — Each agent gets its own email address. Human to Agent, Agent to Agent, All in one place.-<p align="center">- <img src="./assets/alook-email_rounded.png" alt="Alook Email" width="500" />+ <img src="./assets/alook-email_rounded.png" alt="Alook agent email inbox" width="500" /></p>-- **Kanban** — Easy multi-tasking-<p align="center">- <img src="./assets/alook-issue_rounded.png" alt="Alook Email" width="500" />+ <img src="./assets/alook-issue_rounded.png" alt="Alook kanban board with agent tasks" width="500" /></p>-- **Calendar** — Agents manage their own schedule.-<p align="center">- <img src="./assets/alook-calendar_rounded.png" alt="Alook Email" width="500" />+ <img src="./assets/alook-calendar_rounded.png" alt="Alook agent calendar and scheduling" width="500" /></p>-- **Local-first & Always-on** — Agents run on your machine. Your codebase never leaves, but reach your agents anytime.--- **Self-learning** — Agents build memory from past work--- **Traceable** — Every instruction, decision, and reply is recorded. Full accountability, no black boxes.-## Bring Your Own Agent@@ -124,7 +118,6 @@ Built with Next.js, Cloudflare Workers, and Bun.-## License[Apache-2.0](LICENSE)diff --git a/package.json b/package.jsonindex e5d83a17f..c45abb18c 100644--- a/package.json+++ b/package.json@@ -13,7 +13,7 @@"typecheck": "turbo run typecheck","lint": "turbo run lint","dev:web": "pnpm --filter @alook/web dev",- "dev:cli": "ALOOK_SERVER_URL=http://localhost:3000 ALOOK_PROJECT_ROOT=$PWD ALOOK_HEALTH_PORT=19515 pnpm --filter @alook/cli dev",+ "dev:cli": "ALOOK_SERVER_URL=http://localhost:3000 ALOOK_PROJECT_ROOT=$PWD/.alook ALOOK_HEALTH_PORT=19515 pnpm --filter @alook/cli dev","dev:email": "pnpm --filter @alook/email-worker dev","dev:ws": "pnpm --filter @alook/ws-do dev","dev:app": "node scripts/dev-app.mjs",diff --git a/src/web/src/components/agent-chat/agent-chat-view.tsx b/src/web/src/components/agent-chat/agent-chat-view.tsxindex 7b4d07c5d..a63eb070d 100644--- a/src/web/src/components/agent-chat/agent-chat-view.tsx+++ b/src/web/src/components/agent-chat/agent-chat-view.tsx@@ -573,7 +573,7 @@ export function AgentChatView({markInboxRead(conversation.id, workspaceId).then(() => refreshInboxCountRef.current()).catch(() => {});- }, 5000);+ }, 1000);return () => {markedReadRef.current = null;clearTimeout(timer);@@ -883,7 +883,7 @@ export function AgentChatView({markInboxRead(conversationId, workspaceId).then(() => refreshInboxCountRef.current()).catch(() => {});- }, 5000);+ }, 1000);const shouldScroll = isNearBottom.current;try {diff --git a/src/web/src/components/flag-popover.tsx b/src/web/src/components/flag-popover.tsxindex 7c48e72c1..cce73b9cc 100644--- a/src/web/src/components/flag-popover.tsx+++ b/src/web/src/components/flag-popover.tsx@@ -10,6 +10,7 @@ import { useFlagCount } from "@/contexts/flag-count-context";import { useAgentChatSheet } from "@/contexts/agent-chat-sheet-context";import { AgentAvatar } from "@/components/avatar";import { relativeTime } from "@/lib/time";+import { Tooltip, TooltipTrigger, TooltipContent } from "@/components/ui/tooltip";import { Flag, ArrowUpRight } from "lucide-react";import Link from "next/link";@@ -63,6 +64,7 @@ export function FlagPopover({const [items, setItems] = useState<FlaggedItem[] | null>(null);const [loading, setLoading] = useState(false);const [open, setOpen] = useState(false);+ const [tooltipOpen, setTooltipOpen] = useState(false);const fetchItems = useCallback(async () => {setItems(null);@@ -93,25 +95,30 @@ export function FlagPopover({if (nextOpen) fetchItems();}}>- <PopoverTrigger- render={- <button- type="button"- className={cn(- "relative flex items-center justify-center size-10 rounded-xl transition-colors duration-200 cursor-pointer",- "text-muted-foreground hover:text-foreground hover:bg-accent",- isActive && "bg-accent text-foreground"- )}- />- }- >- <Flag className="size-4" />- {flagCount > 0 && (- <span className="absolute top-1 right-1 flex items-center justify-center min-w-3.5 h-3.5 rounded-full bg-primary text-primary-foreground text-[9px] font-bold px-0.5">- {flagCount > 99 ? "99+" : flagCount}- </span>- )}- </PopoverTrigger>+ <Tooltip open={open ? false : tooltipOpen} onOpenChange={setTooltipOpen}>+ <PopoverTrigger+ render={+ <TooltipTrigger render={+ <button+ type="button"+ className={cn(+ "relative flex items-center justify-center size-10 rounded-xl transition-colors duration-200 cursor-pointer",+ "text-muted-foreground hover:text-foreground hover:bg-accent",+ isActive && "bg-accent text-foreground"+ )}+ />+ } />+ }+ >+ <Flag className="size-4" />+ {flagCount > 0 && (+ <span className="absolute top-1 right-1 flex items-center justify-center min-w-3.5 h-3.5 rounded-full bg-primary text-primary-foreground text-[9px] font-bold px-0.5">+ {flagCount > 99 ? "99+" : flagCount}+ </span>+ )}+ </PopoverTrigger>+ <TooltipContent side="right">Flagged</TooltipContent>+ </Tooltip><PopoverContent side="right" className="w-80 p-0"><div className="flex items-center justify-between px-3 py-2 border-b border-border/50"><span className="text-xs font-medium">Flagged</span>diff --git a/src/web/src/components/inbox-popover.tsx b/src/web/src/components/inbox-popover.tsxindex 777741612..5b23ac623 100644--- a/src/web/src/components/inbox-popover.tsx+++ b/src/web/src/components/inbox-popover.tsx@@ -11,6 +11,7 @@ import { useAgentChatSheet } from "@/contexts/agent-chat-sheet-context";import { AgentAvatar } from "@/components/avatar";import { relativeTime } from "@/lib/time";import { getInboxFilterTypes } from "@/lib/inbox-filter";+import { Tooltip, TooltipTrigger, TooltipContent } from "@/components/ui/tooltip";import { Inbox, ArrowUpRight } from "lucide-react";import Link from "next/link";@@ -64,6 +65,7 @@ export function InboxPopover({const [items, setItems] = useState<InboxItem[] | null>(null);const [loading, setLoading] = useState(false);const [open, setOpen] = useState(false);+ const [tooltipOpen, setTooltipOpen] = useState(false);const fetchItems = useCallback(async () => {setItems(null);@@ -101,25 +103,30 @@ export function InboxPopover({}}}>- <PopoverTrigger- render={- <button- type="button"- className={cn(- "relative flex items-center justify-center size-10 rounded-xl transition-colors duration-200 cursor-pointer",- "text-muted-foreground hover:text-foreground hover:bg-accent",- isActive && "bg-accent text-foreground"- )}- />- }- >- <Inbox className="size-4" />- {inboxCount > 0 && (- <span className="absolute top-1 right-1 flex items-center justify-center min-w-3.5 h-3.5 rounded-full bg-primary text-primary-foreground text-[9px] font-bold px-0.5">- {inboxCount > 99 ? "99+" : inboxCount}- </span>- )}- </PopoverTrigger>+ <Tooltip open={open ? false : tooltipOpen} onOpenChange={setTooltipOpen}>+ <PopoverTrigger+ render={+ <TooltipTrigger render={+ <button+ type="button"+ className={cn(+ "relative flex items-center justify-center size-10 rounded-xl transition-colors duration-200 cursor-pointer",+ "text-muted-foreground hover:text-foreground hover:bg-accent",+ isActive && "bg-accent text-foreground"+ )}+ />+ } />+ }+ >+ <Inbox className="size-4" />+ {inboxCount > 0 && (+ <span className="absolute top-1 right-1 flex items-center justify-center min-w-3.5 h-3.5 rounded-full bg-primary text-primary-foreground text-[9px] font-bold px-0.5">+ {inboxCount > 99 ? "99+" : inboxCount}+ </span>+ )}+ </PopoverTrigger>+ <TooltipContent side="right">Unread</TooltipContent>+ </Tooltip><PopoverContent side="right" className="w-80 p-0"><div className="flex items-center justify-between px-3 py-2 border-b border-border/50"><span className="text-xs font-medium">Unread</span>