Ozyman

Personal Operator OS — a private career + life operator buddy: Gmail, GitHub, tasks, Top-3 kicks, chat with tools, confirm before irreversible actions.

Product	Operate today in accounts you already have
Not this	Job boards (Disha), FSRS study (Scholar-Loop), creative ideation (IdeaForge)
Stack	Next.js 15 · InsForge (auth/Postgres) · Composio · OpenRouter
InsForge project	ozyman · ap-southeast · https://sik8rdbp.ap-southeast.insforge.app

Docs (start here)

Doc	Purpose
docs/STATUS.md	Handoff — what works, known gaps, resume checklist
docs/portfolio-product-boundaries.md	Ozyman vs Disha vs Scholar-Loop vs IdeaForge
docs/design-ozyman-personal-operator-os.md	Full design (architecture, schema, PR plan)
docs/setup.md	Env matrix, secrets, Composio project key, migrations
.env.example	Env template (copy to .env.local)
AGENTS.md	Guidance for coding agents

Quick start

cp .env.example .env.local
# Fill NEXT_PUBLIC_INSFORGE_*, OPENROUTER_*, COMPOSIO_API_KEY (prefer ak_ project key)
# See docs/setup.md

npm install
npm run dev

Open http://localhost:3000. Sign in with Google OAuth (preferred).

Command	Purpose
npm run dev	Local Next.js (default port 3000)
npm run build	Production build
npm run typecheck	tsc --noEmit
npm start	Serve production build

App map

Route	What
/	Home — greeting + Top 3 Kicks (Generate/Refresh)
/chat	Companion chat + tools + confirm UI
/tasks	Open / proposed tasks
/settings	Account, sign out, connected apps, Manage apps (Link/Verify)
/connections	Redirects → /settings

Architecture

graph TB
    User([Browser])

    subgraph Next.js App Router
        Home["/ — Kicks Card"]
        Chat["/chat — Agent Chat"]
        Tasks["/tasks — Task Board"]
        Settings["/settings — Connections"]
        BriefAPI["/api/brief/run"]
        AgentRun["/api/agent/run"]
        AgentConfirm["/api/agent/confirm"]
        ConnStatus["/api/connections/status"]
        ConnLink["/api/connections/[toolkit]/link"]
        Smoke["/api/connections/smoke"]
    end

    subgraph InsForge
        Auth["SSR Auth (cookies, PKCE)"]
        Postgres[("Postgres\nprofiles · threads\nmessages · tasks\nconnections · agent_runs\ntool_runs · artifacts")]
        Storage["Storage (later)"]
    end

    subgraph OpenRouter
        LLM["GPT-4.1 Mini\n(morning brief + chat)"]
    end

    subgraph Composio ["Composio (ak_ project key)"]
        Entity["Entity ozyman:<userId>"]
        Gmail["Gmail\nread / search / send"]
        GitHub["GitHub\nissues / PRs / repos"]
        Slack["Slack\nchannels / messages"]
    end

    User --> Home & Chat & Tasks & Settings
    Home --> BriefAPI
    Chat --> AgentRun --> AgentConfirm
    Settings --> ConnStatus & ConnLink & Smoke

    BriefAPI --> LLM
    AgentRun --> LLM

    AgentRun --> Gmail & GitHub & Slack
    BriefAPI --> Gmail & GitHub

    Gmail & GitHub & Slack --> Entity
    Entity --> Auth

    Home & Chat & Tasks --> Postgres
    AgentRun --> Postgres
    BriefAPI --> Postgres
    Auth --> Postgres

Loading

Composio

UI	Settings → Manage apps
Code	lib/composio/*
Key	Project ak_… for multi-user/cloud; never NEXT_PUBLIC_*
Entity	ozyman:<insforge_user_id> in project mode (KD 17)

Database

SQL under migrations/:

npx @insforge/cli db migrations up --all

Requires linked project (.insforge/project.json — gitignored).

Do not commit

• Any .env* except .env.example
• .insforge/ (CLI credentials)
• Live API keys

Sibling projects

Repo	Role
~/Projects/Disha	Job market intelligence
~/Projects/Scholar-Loop	FSRS learn/quiz digests
~/Projects/IdeaForge	Creative synthesis (scaffold)