diff --git a/README.md b/README.md index cbe0c52..9e9ffc3 100644 --- a/README.md +++ b/README.md @@ -1,31 +1,34 @@

- - - Second + + Second — humans and agents, side by side

-

Second

+
-

- The factory for custom internal software,
purpose-built for human2agent work. -

+
-

- License   - Try it   - Platform -

+ + + + Second + -

⭐ Like what we're doing? Give us a star ⬆️

+

Second

-

- Quick Start   |   - Docs   |   - Security & Governance   |   - Self-Hosting -

+**Humans and agents, side by side.** + +Second is a factory for custom internal software,
purpose-built for human2agent work. + + + +CI   +Try it + +Quick Start · Docs · Security & Governance · Self-Hosting + +
## Quick Start Run Second locally: @@ -38,70 +41,72 @@ npx --yes @second-inc/cli | Apple Silicon Mac (M1-M5) | **Available now** | | Intel Mac, Linux, Windows | Coming soon | -
- -## What is Second? - -Second is a factory for shipping internal software built for human-agent collaboration. - -Most platforms were not built for deep, multiplayer, asynchronous work with AI agents. They either treat agents as an afterthought bolted onto existing tools, or they're too opinionated and end up not fitting how your team actually works. Generally, multiplayer human-agent work is where coordination gets hard and things start to break. - -**Second solves that:** imagine an on-prem, secure Lovable for building complete internal software (e.g. competitor research, lead enrichment, various pipelines) **that treats agents as first-class citizens:** agents read and write to the same real-time DB as your human team does, get dynamically generated, scoped tools to do the work inside the apps you've built, and most importantly work alongside your human team. - -Second is open-source, self-hosted, bring your own agent. - -> [!TIP] -> **Enterprise deployment?** See [Enterprise Deployment and Security](https://docs.second.so/enterprise). -> -> Need help with security, SSO, deployment, cost management, runtime setup, and SLA support? Contact [sales@second.so](mailto:sales@second.so). - -## Bring Your Agent - -Bring your own agent harness, switch runtimes and models per message, per app, without restarting conversations. +Bring your agent: - - - - - - - - - +
+ Claude Code + Codex + OpenCode
Claude CodeCodexOpenCode
✅ ✅Coming soonSoon
-## Core Philosophy: Agent-Native Software +
-Every app you build in Second treats **agents as first-class citizens**: they read and write to the same real-time DB your team works on, get scoped and secure tools to get the job done inside the apps you've built, and work alongside humans. +## What is Second? -On top of that, Second handles the hard parts: +Second is a local / on-prem Lovable for building internal software (e.g. competitor research, lead enrichment) **that treats agents as first-class citizens:** AI Agents work inside the apps you build, right alongside your team. They read and write to the same real-time DB as your team does, get scoped tools to handle real workloads inside the apps you've built, and perform actual work instead of just answering questions. -| Capability | How It Works | -|---|---| -| **Multi-agent orchestration** | Run multiple specialized agents per app: one for research, one for alerts, one for enrichment | -| **Long-running async work** | Agents run scheduled jobs, periodic research, etc. | -| **Live data persistence** | MongoDB-backed collections with Change Streams; data survives browser close, agent restarts, and worker churn | +### How it Works -## Personal Software Factory +Second is a single workspace. -Every app you build in Second gets a real-time DB, audit logs, RBAC, agent RBAC, and governance tools built into the workspace. +1. **You describe your app.** In a single prompt. +2. **Second generates it.** The agents, scoped tools, and a beautiful UI, backed by a real-time DB. +3. **Your team now works alongside agents** in the same shared custom software you've built. + + + + + +
+

Example: competitor tracker app built on Second

+

This example features agents discovering new competitors, enriching them, and generating a weekly recap deck from all available information.

+ +

•

+

Second is the most powerful way to build custom GUIs for agents.
Production-ready software for your team, deployed in your VPC, built around your workflows.

+
+
+ +## Second VS other solutions -Companies like **Ramp** and **Deel** have already figured out that teams are building amazing things internally with Claude, Codex, or Lovable, but most of these projects never reach production because of various reasons (security, integrations, governance, safe deployments, maintenance, agent access control, and so on...). +Most platforms weren't built for multiplayer, async work with agents. They either treat agents as an afterthought bolted onto existing tools, or they're too opinionated and end up not fitting how your team actually works.\ +**Generally, multiplayer human-agent work is where coordination gets hard and things start to break.** -**To solve this, they built internal platforms for themselves. Second lets every organization have that.** +Second solves that: Think Paperclip or Multica, but instead of pre-built software you get to build your own custom GUI to work with a team of agents, tailored to your company's needs! + + + +--- + +## The Internal Platform Everyone Needs (and Builds) + +Companies like **Ramp** and **Deel** have already figured out that teams are building amazing things internally with Claude, Codex, or Lovable- but most never reach production (security, governance, integrations, maintenance, agent access control...). To solve this, they built internal platforms for themselves. + +**Second lets every organization have that.** + +Every app you build in Second gets a real-time DB, audit logs, RBAC, agent RBAC, and governance tools built into the workspace. @@ -111,72 +116,175 @@ Companies like **Ramp** and **Deel** have already figured out that teams are bui
  • Build custom apps from a single prompt
  • Run multiple agents in parallel across workflows
  • Real-time collaborative UI with agents and humans on the same page
    • -
  • No code required — designed for non-technical teams
    • +
  • Never blocked: integrations return mock data until connected
    • -

    🛠️ For Platform Engineers

      +
    • Fine-grained access control per app, per agent, per integration
    • One-time workspace setup, unlimited apps
    • Full governance: draft/review/publish lifecycle
      • -
    • Fine-grained access control per app, per agent, per integration
    • Deploy on your own k8s, air-gapped or on-prem
    -
    +> [!TIP] +> **Enterprise deployment?** See [Enterprise Deployment and Security](https://docs.second.so/enterprise). +> +> Need help with security, SSO, deployment, cost management, runtime setup, and SLA support? Contact [sales@second.so](mailto:sales@second.so). + --- ## Features +| Feature |   | +|:---|:---| +| **🔧 Self-Building** | Integrations are generated on demand with exact connection instructions | +| **🤖 App Agents** | Each app gets its own agents, with tools and data access presented for approval | +| **🔌 BYO Agent** | Use Claude Code, Codex, OpenCode, or your own harness. Switch runtimes per app or message | +| **⚡ Realtime** | Live data, change streams, and optimistic updates keep teams and agents synced | +| **👥 Multiplayer Sessions** | Talk with your agents, invite teammates into the session, and collaborate with shared context | +| **🔒 Agent Permissions** | Agents run with approved tools, data, and integrations. Everything is scoped and audited | +| **🛡️ Governance** | Draft, review, approve, and publish apps with agents and integrations under control | +| **📋 Audit Logs** | Every agent action, tool call, data write, and access denial recorded and searchable | +| **🏠 Self-Hosted / On-Prem** | Deploy on your own infrastructure. Your k8s cluster, your VPC, your rules | +| **🧠 Workspace Agents** | Create reusable agents with prompts, skills, models, and team visibility | +| **📚 Workspace Skills** | Define instructions once, then attach them to agents across the workspace | +| **⏲️ Scheduled Agent Jobs** | Agents run on a schedule for periodic research, monitoring, and background tasks | +| **🚀 One-Command Setup** | From zero to running with `npx @second-inc/cli` | + +## What You Can Build + - - - - - - - - - - -
    -

    🔧 Self-Building Integrations

    -Second builds itself: integrations are generated on demand with exact connection instructions. -    		 -

    🤖 App Agents

    -Each app gets its own agents, with tools and data access presented for approval. -    		 -

    🔌 BYO Agent

    -Use Claude Code, Codex, OpenCode, or your own harness. Switch runtimes per app or message. -
    -

    👥 Multiplayer Sessions

    -Talk with Claude Code or Codex, invite teammates into the session, and collaborate with shared context. -    		 -

    🔒 Permissions

    -Agents run with approved tools, data, and integrations. Everything is scoped and audited. -    		 -

    ⚡ Realtime

    -Live data, change streams, and optimistic updates keep teams and agents synced. +    		 + +
    + +

    🎯 Lead Enrichment Pipeline

    + +**Flow:** 🤖 Scrape leads → 🤖 Enrich from LinkedIn + web → 🤖 Score and rank → 👤 Team reviews top leads
    +**Tools:** HubSpot, LinkedIn, Web Search
    +**Agents:** Scraper Agent, Enrichment Agent, Scoring Agent + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    PIPELINE 47 leads ▼
    LeadScoreStatus
    Acme Corp92/100✅ Ready
    👤 [Call]
    Nova Labs78/100🤖 Enriching
    🤖 Score next
    Peak Inc--🤖 Scraping...
    3 sources
    💬 Scoring Agent
    "Acme Corp: 200 employees, Series A, hiring 3 engineers. Score: 92. Ready for review."

    👤 [Accept] [Edit] [Skip]
    +
    -

    🧠 Workspace Agents

    -Create reusable agents with prompts, skills, models, and team visibility. -    		 -

    📚 Workspace Skills

    -Define instructions once, then attach them to agents across the workspace. -    		 -

    🛡️ Governance

    -Draft, review, approve, and publish apps with agents and integrations under control. +    		 + +
    + +

    📊 GTM War Room

    + +**Flow:** 🤖 Agent pulls weekly metrics → 👤 PMM reviews positioning → 👤 Sales adds field notes → 🤖 Agent generates battlecard
    +**Tools:** HubSpot, Slack, Google Docs, Analytics
    +**Agents:** Metrics Agent, Battlecard Agent + +
    + + + + + + + + + + + + + + + + + + + + + + +
    GTM WAR ROOMWeek 21 ▼
    📈THIS WEEK
    Pipeline: $320k (+14%)
    Win rate: 38% (up from 31%)
    Lost to competitor: 3 deals
    👤PMM added positioning note
    "Emphasize self-hosted angle vs. Acme's cloud-only offer"
    👤Sales added field note
    "Acme offering 40% discounts to win back churned accounts"
    🤖Battlecard Agent
    "Updated battlecard with new field intel. 2 new objection handlers added."

    👤 [Review card] [Push to Docs]
    +
    +And many more: + +| Use Case | What It Does | Tools | Agents | +|:---|:---|:---|:---| +| **Competitor Research Dashboard** | Monitor competitor changes, review and flag important updates, compile reports, and share research | Web Search, Google Alerts, Drive | Research Agent, Alert Agent, Report Agent | +| **Content Curation Pipeline** | Fetch videos, select clips, cut and upload assets, and route finished content for approval | YouTube API, Clipping Service, Google Drive | Curator Agent, Clip Agent | +| **Social Media Ops** | Draft posts, schedule across platforms, track engagement, repurpose top performers | Twitter/X, LinkedIn, Buffer | Content Agent, Scheduling Agent, Analytics Agent | +| **Recruiting Pipeline** | Source candidates, screen resumes, schedule interviews, track pipeline | LinkedIn, ATS, Google Calendar, Gmail | Sourcing Agent, Screening Agent, Scheduling Agent | +| **Customer Success** | Pull data from CRMs and support tools, surface churn risk, draft outreach | HubSpot, Intercom, Slack | Insights Agent, Churn Agent, Outreach Agent | +| **Invoice & Expense Tracking** | Collect invoices from email, extract data, match to POs, flag discrepancies | Gmail, Google Drive, Accounting API | Extraction Agent, Matching Agent, Approval Agent | +| **Compliance Monitoring** | Scan for policy violations, flag issues, route to approvers | Internal APIs, Slack, Jira | Compliance Agent, Triage Agent, Routing Agent | +| **Internal Knowledge Base** | Continuously index docs, summarize updates, answer team questions | Notion, Confluence, Slack | Indexing Agent, Summary Agent, Q&A Agent | +| **Founder's Daily Brief** | Aggregate metrics, news, emails, and calendar into one morning summary | Gmail, Google Calendar, Analytics, Web Search | Metrics Agent, News Agent, Brief Agent | +| **PR & Media Monitoring** | Track brand mentions, analyze sentiment, draft responses, alert on crises | Web Search, Twitter/X, Slack, Google Docs | Monitor Agent, Sentiment Agent, Response Agent | +| **Product Feedback Loop** | Collect feedback from support tickets, reviews, and calls, cluster themes, surface to PM | Intercom, G2, Gong, Slack | Collection Agent, Clustering Agent, Summary Agent | +| **Vendor & Contract Management** | Track renewal dates, compare pricing, flag expiring contracts, draft RFPs | Gmail, Notion, Slack | Tracker Agent, Comparison Agent, Draft Agent | +| **SEO Content Pipeline** | Research keywords, generate briefs, draft articles, track rankings | Ahrefs, Web Search, Notion, Analytics | Research Agent, Brief Agent, Writer Agent | +| **Security Alert Triage** | Ingest alerts from multiple tools, deduplicate, prioritize, assign to on-call | PagerDuty, Slack, Jira, SIEM API | Ingestion Agent, Triage Agent, Assignment Agent | +| **Meeting Follow-ups** | Record action items from meetings, assign owners, send follow-up emails, track completion | Google Calendar, Gong, Gmail, Notion | Notes Agent, Follow-up Agent, Tracker Agent | + + + +--- + +## Why Second is Special + +**Second generates dynamic, agent-native software.** For each app: + +- **Scoped tools created per app, for every agent.** Agents can never do things you don't want them to do. +- **Second is true self-building software.** It generates the integrations, connection instructions, and scoped tools. +- **Agents never see secrets.** Secrets are injected server-side. +- **`agents.json`: governed policy as code.** Each app has an `agents.json`. Changes require admin approval via hash verification. +- **Draft and published are fully separated.** Builders iterate freely with mock data. Published apps only run the last approved config. + +On top of that, Second handles the hard parts: + +| Capability |   | +|:---|:---| +| **🤹 Multi-agent orchestration** | Multiple specialized agents per app | +| **⏲️ Long-running async work** | Scheduled jobs, periodic research, background tasks | +| **🗃️ Live data persistence** | Real-time DB with Change Streams; survives restarts and churn | + -## Problems Second Solves + -Your team sees everything in one collaborative interface. Agents write to the same database your team reads from, no export, no copy-paste, no context switching. - --- ## Security & Governance diff --git a/docs/assets/readme_cover.jpg b/docs/assets/readme_cover.jpg new file mode 100644 index 0000000..3da434b Binary files /dev/null and b/docs/assets/readme_cover.jpg differ diff --git a/docs/assets/readme_cover.webp b/docs/assets/readme_cover.webp new file mode 100644 index 0000000..9c3063a Binary files /dev/null and b/docs/assets/readme_cover.webp differ