ff80b049 3eff 495f b4f0 c4071d615994

blob 2dc445ab30cc009392c9e583b2bb3b0f6cd03198 22153752 docs/assets/demo.mp4
blob fcc7dd2db7536f43dce76372c2b03e639d38a537 2025449 images/AgentDataFlowV2.gif
blob 4b8f26a8938d41c4019bfce42c61ca200d0829c1 1414769 docs/assets/dashboard.gif
blob 187d88b8ba37d7dea0167c9f312c5c96182e6bb9 1264207 images/app.png
blob a7a5a2803e346cb6af1c7c286db5ce426f8d7e23 1038025 images/claude-code-multi-agent-orchestration.png
blob 09ebcca9421e3624dcc86fc647cd9b594ddf9f80 820442 images/AgentDataFlowV2_compressed.mp4
blob 631b0454aba827e5495757c6173d1fefb4935d11 203468 app/client/package-lock.json
blob 6af475d6c271d90b3b96e79c0f371bfb4287d6ee 193694 docs/assets/dashboard1.png
blob de09a0924e18a05c4e40c3c8e63f37af96434eb6 178109 docs/assets/dashboard2.png
blob db3df9584467d511aefe44e7fbc298eeca91539b 160448 docs/assets/dashboard2.png
blob f973b587ca478c48aa1b4abbd902a76e3e1fa9be 156790 app/client/package-lock.json
blob 2ff04a4a7e57d4085e0b29a75584132fa74c98ed 156150 app/client/package-lock.json
blob ff743580495accdd70ed60c458a60851816518e7 155273 app/client/package-lock.json
blob 1c1cd68b41b7090530fb0b84bac723b21bbbfea0 154952 app/client/package-lock.json
blob c75c6c60ea29e78e43be91f4ef8540b324667209 154229 app/client/package-lock.json
blob 63518683eabfacecfca10f02ad7d6df826347d9f 146079 docs/assets/dashboard1.png
blob dda4727f6721bbb9fd74d57c48eac918f82a4dbf 117662 app2/client/package-lock.json
blob 6a8d48fefd677e5bbaef541b09fb6b447b3fd1e4 117659 app/client/package-lock.json
blob ebed832e41e29e4052698ee793a94f4e02cbcd09 71699 app/server/package-lock.json
blob b21368c4e0408a0ea373e7c9049cddb79a25b691 57794 ai_docs/claude_agent_sdk_python.md

Found 8 files
app/client/src/stores/ui-store.ts
app/client/src/stores/ui-store.test.ts
app/client/src/hooks/use-icon-customizations.ts
app/client/src/hooks/use-agents.ts
app/client/src/config/event-icons.ts
app/client/src/components/timeline/activity-timeline.tsx
app/client/src/components/main-panel/main-panel.tsx
app/client/src/components/main-panel/main-panel.test.tsx

1	import { useCallback, useRef, useMemo, useState, useEffect } from 'react'
2	import { useUIStore } from '@/stores/ui-store'
3	import { useEvents } from '@/hooks/use-events'
4	import { useAgents } from '@/hooks/use-agents'
5	import { useSessions } from '@/hooks/use-sessions'
6	import { buildAgentColorMap, getAgentColorById } from '@/lib/agent-utils'
7	import { AgentLane } from './agent-lane'
8	import { Button } from '@/components/ui/button'
9	import { TooltipProvider } from '@/components/ui/tooltip'
10	import type { Agent, ParsedEvent } from '@/types'
11	
12	export function ActivityTimeline() {
13	  const {
14	    selectedProjectId,
15	    selectedSessionId,
16	    selectedAgentIds,
17	    timelineHeight,
18	    timeRange,
19	    setTimelineHeight,
20	    setTimeRange,
21	  } = useUIStore()
22	
23	  const { data: sessions } = useSessions(selectedProjectId)
24	  const effectiveSessionId = selectedSessionId || sessions?.[0]?.id || null
25	  const { data: events } = useEvents(effectiveSessionId)
26	  const agents = useAgents(effectiveSessionId, events)
27	  const resizing = useRef(false)
28	  const startY = useRef(0)
29	  const startHeight = useRef(0)
30	
31	  // Periodic cleanup tick: forces re-render so expired dots are removed from DOM.
32	  // Also triggers when new events arrive.
33	  const [, setCleanupTick] = useState(0)
34	  useEffect(() => {
35	    const id = setInterval(() => setCleanupTick((t) => t + 1), 5_000)
36	    return () => clearInterval(id)
37	  }, [])
38	  const eventsLength = events?.length ?? 0
39	  useEffect(() => {
40	    setCleanupTick((t) => t + 1)
41	  }, [eventsLength])
42	
43	  const flatAgents = useMemo(() => {
44	    const mainAgents: { agent: Agent; isSubagent: boolean }[] = []
45	    const nonMainAgents: { agent: Agent; isSubagent: boolean }[] = []
46	    for (const a of agents) {
47	      if (selectedAgentIds.length > 0 && !selectedAgentIds.includes(a.id)) continue
48	      if (!a.parentAgentId) {
49	        mainAgents.push({ agent: a,
…

app/client/src/components/timeline/activity-timeline.tsx
app/client/src/components/timeline/agent-lane.tsx

1	import { useRef, useMemo, useCallback } from 'react'
2	import { cn } from '@/lib/utils'
3	import { getEventIcon, getEventColor } from '@/config/event-icons'
4	import { getEventSummary } from '@/lib/event-summary'
5	import { useUIStore } from '@/stores/ui-store'
6	import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip'
7	import { AgentLabel } from '@/components/shared/agent-label'
8	import type { Agent, ParsedEvent } from '@/types'
9	
10	// Renders event dots with CSS-driven drift animation.
11	// Each dot mounts at its current position and CSS-transitions to -5% (off-screen).
12	// On scale change, all dots are unmounted and remounted via a key change.
13	function DotContainer({
14	  events,
15	  rangeMs,
16	  generation,
17	  setScrollToEventId,
18	}: {
19	  events: ParsedEvent[]
20	  rangeMs: number
21	  generation: number
22	  setScrollToEventId: (id: number | null) => void
23	}) {
24	  return (
25	    <>
26	      {events.map((event) => {
27	        const age = Date.now() - event.timestamp
28	        const position = 100 - (age / rangeMs) * 100
29	        if (position < -10 || position > 100) return null
30	
31	        const remainingMs = Math.max(0, rangeMs - age)
32	        const Icon = getEventIcon(event.subtype, event.toolName)
33	        const { dotColor, customHex } = getEventColor(event.subtype, event.toolName)
34	        const summary = getEventSummary(event)
35	
36	        return (
37	          <Tooltip key={`${event.id}-${generation}`}>
38	            <TooltipTrigger asChild>
39	              <button
40	                className="absolute top-1/2 -translate-y-1/2 -translate-x-1/2 cursor-pointer hover:scale-125"
41	                style={{ left: `${position}%` }}
42	                ref={(el) => {
43	                  if (!el) return
44	                  // Start drift: set position without transition, then animate to off-screen
45	                  requestAnimationFrame(() => {
46	                    el.style.transition = `lef
…

agents-observe Up About an hour

no local db file

-rw-r--r-- 1 root root 876K Apr  1 22:00 /data/observe.db
[
    {
        "Type": "bind",
        "Source": "/Users/jessitron/.claude/plugins/data/agents-observe-agents-observe/data",
        "Destination": "/data",
        "Mode": "",
        "RW": true,
        "Propagation": "rprivate"
    }
]

329|2

Found 6 files
app/client/src/components/ui/popover.tsx
app/client/src/components/ui/alert-dialog.tsx
app/client/src/components/sidebar/sidebar.tsx
app/client/src/components/settings/projects-tab.tsx
app/client/src/components/settings/icon-settings.tsx
app/client/src/components/main-panel/scope-bar.tsx

No matches found

1	import { useCallback, useRef, useState } from 'react'
2	import { PanelLeftClose, PanelLeftOpen, Moon, Sun, Wifi, WifiOff, Settings } from 'lucide-react'
3	import { cn } from '@/lib/utils'
4	import { useUIStore } from '@/stores/ui-store'
5	import { useTheme } from '@/components/theme-provider'
6	import { ProjectList } from './project-list'
7	import { Button } from '@/components/ui/button'
8	import { Separator } from '@/components/ui/separator'
9	import { SettingsModal } from '@/components/settings/settings-modal'
10	
11	interface SidebarProps {
12	  connected: boolean
13	}
14	
15	export function Sidebar({ connected }: SidebarProps) {
16	  const { sidebarCollapsed, sidebarWidth, setSidebarCollapsed, setSidebarWidth } = useUIStore()
17	  const { theme, toggleTheme } = useTheme()
18	  const resizing = useRef(false)
19	  const [settingsOpen, setSettingsOpen] = useState(false)
20	
21	  const sidebarRef = useRef<HTMLDivElement>(null)
22	
23	  const handleMouseDown = useCallback(
24	    (e: React.MouseEvent) => {
25	      if (sidebarCollapsed) return
26	      e.preventDefault()
27	      resizing.current = true
28	      // Disable CSS transition during drag for smooth resizing
29	      if (sidebarRef.current) sidebarRef.current.style.transition = 'none'
30	
31	      const onMouseMove = (e: MouseEvent) => {
32	        if (!resizing.current) return
33	        const newWidth = Math.max(200, Math.min(400, e.clientX))
34	        if (sidebarRef.current) sidebarRef.current.style.width = `${newWidth}px`
35	      }
36	
37	      const onMouseUp = (e: MouseEvent) => {
38	        resizing.current = false
39	        if (sidebarRef.current) sidebarRef.current.style.transition = ''
40	        const finalWidth = Math.max(200, Math.min(400, e.clientX))

76:            <span className="text-sm font-semibold truncate">Observe</span>

70	            className="flex items-center gap-2 cursor-pointer hover:opacity-80 transition-opacity"
71	            onClick={() => { useUIStore.getState().setSelectedProject(null) }}
72	          >
73	            <div className="flex h-7 w-7 shrink-0 items-center justify-center rounded-md bg-primary text-primary-foreground text-xs font-bold">
74	              O
75	            </div>
76	            <span className="text-sm font-semibold truncate">Observe</span>
77	          </button>
78	        )}
79	        {!sidebarCollapsed && <div className="flex-1" />}
80	        <Button
81	          variant="ghost"
82	          size="icon"
83	          className="h-7 w-7 shrink-0"
84	          onClick={() => setSidebarCollapsed(!sidebarCollapsed)}

The file /Users/jessitron/code/simple10/agents-observe/app/client/src/components/sidebar/sidebar.tsx has been updated successfully.

justfile:1:# Agents Observe
justfile:6:# Server port is used for both local dev & docker starts
justfile:7:# Client port is only for local dev
justfile:14:dev_client_port := env("AGENTS_OBSERVE_CLIENT_PORT", "5174")
justfile:16:server := project_root / "app" / "server"
justfile:18:cli_script := project_root / "hooks" / "scripts" / "observe_cli.mjs"
justfile:29:    docker build -t agents-observe:local .
justfile:32:start:
justfile:34:    @docker compose down >/dev/null 2>&1 || true
justfile:35:    @docker rm -f agents-observe >/dev/null 2>&1 || true
justfile:38:    @echo "Waiting for server..."
justfile:40:      if curl -sf http://localhost:{{ port }}/api/health >/dev/null 2>&1; then \
justfile:48:# Start the server locally without docker
justfile:49:start-local:
justfile:51:    npm run start
justfile:55:    @docker compose down >/dev/null 2>&1 || true
justfile:56:    @docker rm -f agents-observe >/dev/null 2>&1 || true
justfile:58:# Restart containers
justfile:59:restart: stop start
justfile:67:# Start local server + client in dev mode (hot reload)
justfile:68:dev:
justfile:70:    echo "Starting dev server + client..."
justfile:72:    echo "Client: http://localhost:{{ dev_client_port }} (Vite dev)"
justfile:74:    cd {{ server }} && npm run dev &
justfile:76:    cd {{ client }} && npm run dev &
justfile:78:    trap 'kill $pid1 $pid2 2>/dev/null; wait $pid1 $pid2 2>/dev/null; exit 0' INT TERM
justfile:80:    just open {{ dev_client_port }}
justfile:83:# Start only the server (dev mode with hot reload)
justfile:84:dev-server:
justfile:85:    cd {{ server }} && npm run dev
justfile:87:# Start only the client (Vite dev server)
justfile:88:dev-client:
justfile:89:    cd {{ client }} && npm run dev
justfile:92:dev-client-build:
justfile:97:# Run all tests (server + client)
justfile:101:# Send a test event to the server
justfile:104:      | AGENTS_OBSERVE_PROJECT_NAME=test-project node {{ project_root }}/hooks/scripts/observe_cli.mjs
justfile:111:    rm -f {{ project_root 
…

1	# Agents Observe
2	# Usage: just <recipe>
3	#
4	# AGENTS_OBSERVE_SERVER_PORT & AGENTS_OBSERVE_CLIENT_PORT are read from .env
5	# Allows for overriding the default ports
6	# Server port is used for both local dev & docker starts
7	# Client port is only for local dev
8	
9	set dotenv-load := true
10	set export := true
11	set quiet := true
12	
13	port := env("AGENTS_OBSERVE_SERVER_PORT", "4981")
14	dev_client_port := env("AGENTS_OBSERVE_CLIENT_PORT", "5174")
15	project_root := justfile_directory()
16	server := project_root / "app" / "server"
17	client := project_root / "app" / "client"
18	cli_script := project_root / "hooks" / "scripts" / "observe_cli.mjs"
19	hook_script := project_root / "hooks" / "scripts" / "hook.sh"
20	

app/server/src/config.ts:41:  dbPath: resolve(process.env.AGENTS_OBSERVE_DB_PATH || '../../data/observe.db'),

no data dir

-rw-r--r--@ 1 jessitron  staff   1.2M Apr  1 17:13 data/observe.db

No matches found

No matches found

1	.DS_Store
2	
3	# TypeScript / JavaScript / Node
4	node_modules/
5	/package-lock.json
6	app/**/dist/
7	*.tsbuildinfo
8	
9	# Bun
10	bun.lockb
11	.bun/
12	
13	# Testing
14	coverage/
15	.nyc_output/
16	*.lcov
17	.coverage
18	htmlcov/
19	
20	# Docker data directory
21	/data/
22	/logs/
23	
24	# Security
25	.env
26	.env.*
27	!.env.example
28	*.key
29	*.pem
30	*.p12
31	*.pfx
32	secrets/
33	credentials/
34	
35	# Misc
36	.superpowers/
37	
38	# Backup & temp
39	bak/
40	
41	.justfile.swp
42	

File created successfully at: /Users/jessitron/code/simple10/agents-observe/.env

1	// app/server/src/config.ts
2	// Central config for the server. All env var reads happen here.
3	
4	import { resolve, dirname } from 'path'
5	import { readFileSync, existsSync } from 'fs'
6	import { fileURLToPath } from 'url'
7	
8	const logLevel = (process.env.AGENTS_OBSERVE_LOG_LEVEL || 'debug').toLowerCase()
9	
10	function detectRuntime(): 'docker' | 'local' {
11	  const explicit = process.env.AGENTS_OBSERVE_RUNTIME
12	  if (explicit === 'docker' || explicit === 'local') return explicit
13	  if (existsSync('/.dockerenv')) return 'docker'
14	  return 'local'
15	}
16	
17	function readVersion(): string {
18	  const dir = dirname(fileURLToPath(import.meta.url))
19	  const paths = [
20	    resolve(dir, '../../../VERSION'),     // dev: app/server/src -> root
21	    resolve(dir, '../../VERSION'),        // Docker: /app/server/src -> /app
22	    '/app/VERSION',                       // Docker fallback
23	  ]
24	  for (const p of paths) {
25	    try {
26	      return readFileSync(p, 'utf8').trim()
27	    } catch {
28	      continue
29	    }
30	  }
31	  return 'unknown'
32	}
33	
34	export const config = {
35	  apiId: 'agents-observe',
36	  runtime: detectRuntime(),
37	  version: readVersion(),
38	  port: parseInt(process.env.AGENTS_OBSERVE_SERVER_PORT || '4981', 10),
39	  logLevel,
40	  verbose: logLevel === 'debug' || logLevel === 'trace',
41	  dbPath: resolve(process.env.AGENTS_OBSERVE_DB_PATH || '../../data/observe.db'),
42	  storageAdapter: process.env.AGENTS_OBSERVE_STORAGE_ADAPTER || 'sqlite',
43	  clientDistPath: process.env.AGENTS_OBSERVE_CLIENT_DIST_PATH || '',
44	}
45	

The file /Users/jessitron/code/simple10/agents-observe/.env has been updated successfully.

/Users/jessitron/code/simple10/agents-observe/data/observe.db

The file /Users/jessitron/code/simple10/agents-observe/.env has been updated successfully.

==> Auto-updating Homebrew...
Adjust how often this is run with `$HOMEBREW_AUTO_UPDATE_SECS` or disable with
`$HOMEBREW_NO_AUTO_UPDATE=1`. Hide these hints with `$HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).
==> Downloading https://ghcr.io/v2/homebrew/core/portable-ruby/blobs/sha256:f41c72b891c40623f9d5cd2135f58a1b8a5c014ae04149888289409316276c72
#=#=#                                                                          
##O#-#                                                                         

################                                                          22.4%
#######################################################################   99.7%
######################################################################## 100.0%
==> Pouring portable-ruby-4.0.2_1.arm64_big_sur.bottle.tar.gz
==> Auto-updated Homebrew!
Updated 5 taps (steipete/tap, hashicorp/tap, steveyegge/beads, homebrew/core and homebrew/cask).
==> New Formulae
copilot-language-server: Language Server Protocol server for GitHub Copilot
crip: Tool to extract server certificates
dispenso: High-performance C++ library for parallel programming
et: Remote terminal with IP roaming
expert: Official Elixir Language Server Protocol implementation
icestorm: Tools for analyzing and creating Lattice iCE40 FPGA bitstream files
jsongrep: Query tool for JSON, YAML, TOML, and other structured formats
lazycut: Terminal-based video trimming TUI
miniaudio: Audio playback and capture library
nextpnr-ice40: Portable FPGA place and route tool for Lattice iCE40
opentimestamps-client: Create and verify OpenTimestamps proofs
pay: HTTP client that automatically handles 402 Payment Required
pipewire-gstreamer: GStreamer Plugin for PipeWire
proxelar: Man-in-the-Middle proxy for HTTP/HTTPS traffic
qtcanvaspainter: Accelerated 2D painting solution for Qt Quick and QRhi-based render targets
qttasktree: General purpose library for asynchronous task execution
wireplumber: Session / policy manager implementation for PipeWir
…

Consider adding one of the following versions in your config file at /Users/jessitron/code/simple10/agents-observe/app/server/.tool-versions
nodejs 25.6.1
nodejs 24.12.0
nodejs 22.21.1
nodejs 22.14.0

Consider adding one of the following versions in your config file at /Users/jessitron/code/simple10/agents-observe/app/client/.tool-versions
nodejs 25.6.1
nodejs 24.12.0
nodejs 22.21.1
nodejs 22.14.0

Starting dev server + client...
Server: http://localhost:4982
Client: http://localhost:5175 (Vite dev)

No version is set for nodejs; please run `asdf set [options] nodejs <version>`
No version is set for nodejs; please run `asdf set [options] nodejs <version>`
No version is set for command node
Consider adding one of the following versions in your config file at /Users/jessitron/code/simple10/agents-observe/app/server/.tool-versions
nodejs 25.6.1
nodejs 24.12.0
nodejs 22.21.1
nodejs 22.14.0
No version is set for command node
Consider adding one of the following versions in your config file at /Users/jessitron/code/simple10/agents-observe/app/client/.tool-versions
nodejs 25.6.1
nodejs 24.12.0
nodejs 22.21.1
nodejs 22.14.0
server not ready yet

  22.14.0
  22.21.1
  24.12.0
  25.6.1

no engines field

no engines
no .tool-versions

v22.21.1

Starting dev server + client...
Server: http://localhost:4982
Client: http://localhost:5175 (Vite dev)


> app-server@1.0.0 dev
> tsx watch src/index.ts


> app-client@1.0.0 dev
> vite

sh: vite: command not found
sh: tsx: command not found
waiting... (1)
waiting... (2)
waiting... (3)
waiting... (4)
waiting... (5)
waiting... (6)
waiting... (7)
waiting... (8)
waiting... (9)
waiting... (10)
Client not ready yet

Exit code 1
ls: /Users/jessitron/code/simple10/agents-observe/app/server/node_modules/.bin/tsx: No such file or directory

  run `npm fund` for details

found 0 vulnerabilities

  run `npm fund` for details

found 0 vulnerabilities

Starting dev server + client...
Server: http://localhost:4982
Client: http://localhost:5175 (Vite dev)


> app-client@1.0.0 dev
> vite


> app-server@1.0.0 dev
> tsx watch src/index.ts

[consumer] Running in dev mode — auto-shutdown is disabled
[WS] WebSocket enabled on /api/events/stream
Server running on http://localhost:4982
POST events: http://localhost:4982/api/events

  VITE v6.4.1  ready in 584 ms


  🚀 Dashboard: http://localhost:5175

  ➜  Local:   http://localhost:5175/
  ➜  Network: use --host to expose
[WS] Client connected (1 total)
[WS] Client disconnected (0 remaining)
[consumer] No active consumers or clients, but within startup grace period — skipping shutdown
{"ok":true,"id":"agents-observe","version":"0.7.4","logLevel":"trace","runtime":"local","dbPath":"/Users/jessitron/code/simple10/agents-observe/data/observe.db","activeConsumers":0,"activeClients":0}
Server is up!
[WS] Client connected (1 total)
[WS] Client unsubscribed
Client is up too!

1	# Contributing to Claude Observe
2	
3	Thanks for your interest in contributing!
4	
5	## Getting started
6	
7	1. Fork the repo and clone it
8	2. Run `just install` to install dependencies
9	3. Run `just dev` to start the dev server
10	4. Make your changes
11	5. Run `just test` to make sure tests pass
12	6. Run `just fmt` to format your code
13	7. Open a pull request
14	
15	## Project layout
16	
17	- `hooks/scripts/` — Hook script and MCP server script
18	- `hooks/hooks.json` — Plugin hook definitions
19	- `skills/` — Plugin skills (`/observe`, `/observe stop`, `/observe status`)
20	- `.claude-plugin/` — Plugin manifest
21	- `app/server/` — Hono server with SQLite storage and WebSocket
22	- `app/client/` — React 19 dashboard with shadcn/ui
23	
24	## Development
25	
26	- **Server**: `just dev-server` starts with hot reload via tsx
27	- **Client**: `just dev-client` starts the Vite dev server
28	- **Both**: `just dev` runs both in parallel
29	
30	## Code style
31	
32	- Run `just fmt` before committing (uses Prettier via `.prettierrc`)
33	- TypeScript throughout — avoid `any` where possible
34	- Keep the hook script dependency-free (Node.js built-ins only)
35	
36	## Reporting issues
37	
38	Open an issue on GitHub with:
39	- What you expected to happen
40	- What actually happened
41	- Steps to reproduce
42	- Your environment (OS, Node version, Claude Code version)
43	

File does not exist. Note: your current working directory is /Users/jessitron/code/simple10/agents-observe.

No files found

origin	https://github.com/simple10/agents-observe (fetch)
origin	https://github.com/simple10/agents-observe (push)

https://github.com/simple10/agents-observe/issues/2

File created successfully at: /Users/jessitron/code/simple10/agents-observe/CLAUDE.md

No matches found

(Bash completed with no output)