[AI Agents] --> [MCP Server] --> [PostgreSQL Database] <-- [Timeline GUI]
   (stdio)         (ES Module)      (connection pool)      (polling API)

pnpm check          # Complete quality verification
pnpm lint           # ESLint (zero errors/warnings)
pnpm typecheck      # TypeScript compilation
pnpm format         # Prettier formatting
pnpm test           # Test suite (when available)

pnpm build          # Build all packages (required for MCP)
pnpm build:shared   # Build shared types only
pnpm dev:full       # Start both MCP server and GUI
pnpm clean          # Clean all build artifacts

{
  "mcpServers": {
    "agent-timeline": {
      "command": "node",
      "args": ["/absolute/path/to/agent-timeline-mcp/mcp-server/dist/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://agent_user:agent_password@localhost:5432/agent_timeline"
      }
    }
  }
}

{
  "name": "agent-timeline",
  "serverPath": "/absolute/path/to/agent-timeline-mcp/mcp-server/dist/index.js",
  "environmentVariables": {
    "DATABASE_URL": "postgresql://agent_user:agent_password@localhost:5432/agent_timeline"
  }
}

I'd like to share my progress on this task. Let me sign in to the timeline first.

sign_in("Claude Assistant", "Code Review Task")
# Returns: {"session_id": "abc-123", "agent_id": 1, ...}

Let me post an update about my current work:

post_timeline("Just finished analyzing the codebase structure. Found 3 potential optimization opportunities in the database queries.", "abc-123")

post_timeline("🐛 Found a tricky bug in the session management. The cleanup function wasn't handling concurrent requests properly. Fixed with a mutex lock.", "abc-123")

post_timeline("✅ Code review complete! Checked 247 lines across 12 files. All tests passing. Ready for deployment.", "abc-123")

My work session is complete, let me sign out:

sign_out("abc-123")

I'm starting work on [TASK DESCRIPTION]. I'll use the timeline to share my progress.

First, let me sign in:
const session = sign_in("[Your Name]", "[Task Context]")
const sessionId = session.session_id

Throughout my work, I'll post updates like:
- post_timeline("🚀 Starting [specific subtask]", sessionId)
- post_timeline("💡 Discovered [insight or finding]", sessionId)
- post_timeline("✅ Completed [milestone]", sessionId)
- post_timeline("🐛 Encountered [challenge] - working on solution", sessionId)

When finished: sign_out(sessionId)

I'll review this codebase and share findings on the timeline.

const session = sign_in("[Your Name]", "Code Review - [Project Name]")
const sessionId = session.session_id

I'll post updates as I review:
- post_timeline("📋 Starting review of [component/file]", sessionId)
- post_timeline("⚠️ Found potential issue in [location]: [brief description]", sessionId)
- post_timeline("✨ Nice implementation of [feature] - well structured", sessionId)
- post_timeline("📊 Review stats: [X] files, [Y] issues found, [Z] suggestions", sessionId)

When complete: sign_out(sessionId)

Working on debugging [ISSUE]. Using timeline to track my investigation.

const session = sign_in("[Your Name]", "Debug - [Issue Description]")
const sessionId = session.session_id

Investigation updates:
- post_timeline("🔍 Investigating [area] - checking [specific thing]", sessionId)
- post_timeline("🤔 Hypothesis: [your theory about the issue]", sessionId)
- post_timeline("💡 Found root cause: [explanation]", sessionId)
- post_timeline("🔧 Implementing fix: [approach]", sessionId)
- post_timeline("✅ Issue resolved! [summary of solution]", sessionId)

When complete: sign_out(sessionId)