diff --git a/README.md b/README.md index 6f0bd2f..cff4bc0 100644 --- a/README.md +++ b/README.md @@ -21,8 +21,6 @@ Second is a factory for custom internal software,
purpose-built for human2agent work. - - CI   Try it @@ -66,15 +64,21 @@ Bring your agent: ## What is Second? -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. +Second is the infrastructure for human2agent work. + +Instead of managing agents in chat windows, **Second lets you orchestrate a team of agents inside custom apps you build around your team's actual needs.** + +From one prompt, Second builds complete apps **that treat agents as first-class citizens:** 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, and get generated, scoped tools to handle real workloads inside your apps. -### How it Works +We believe custom apps are the right abstraction for continuous work with a team of agents. Chat is great for one-off tasks, but shared state, queues and pipelines require real software where humans and agents can work on the same page. -Second is a single workspace. +### How It Works + +Second is a single workspace that creates production-ready apps. 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. +3. **Your team now works alongside agents** in the same shared custom software. @@ -90,14 +94,11 @@ Second is a single workspace.
-## Second VS other solutions - -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.** +## Second vs. Other Solutions -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! +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. - +Second solves that: think Paperclip or Multica, but instead of pre-built software you get to build your own custom GUI for a team of agents, tailored to your company's needs. --- @@ -139,19 +140,37 @@ Every app you build in Second gets a real-time DB, audit logs, RBAC, agent RBAC, --- +## Core Philosophy + +| Principle | What it means in Second | +|:---|:---| +| **Build the app, not just the agent.** | The durable artifact is working internal software: a focused UI, live data, team workflows, and agents that operate inside that product. | +| **Agents are first-class citizens.** | Apps can include multiple named agents with roles, tools, data access, schedules, and visible run history. They are not bolted-on chat widgets. | +| **Humans stay in command.** | Plans, agent configs, integration setup, and publishing go through explicit review. Agents can work freely only inside the boundaries you approved. | +| **Small tools beat broad access.** | The builder creates scoped tools for the specific app and use case. Tools are tied to approved domains, collections, integration grants, and secret placeholders. | +| **Integrations should self-build.** | Instead of starting with a giant MCP catalog or handing agents every connector, Second generates the narrow integration contract and human setup instructions the app actually needs. | +| **Collaboration is the runtime.** | Agent-to-agent and agent-to-human work happens through the app's shared state, realtime updates, resumable streams, comments, approvals, and audit trail. | +| **Generated software must still be real software.** | Draft and published snapshots are separated, source is persisted, builds are checked, data survives restarts, and production access follows the same tenant and permission model. | +| **Local-first, on-prem-ready.** | Start on your machine. Deploy inside your cloud when the workflow matters. Your VPC, your auth provider, your secrets, your rules. | + +--- + ## 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 | +| **๐Ÿ”ง Prompt-to-App Generation** | Generate internal apps, data models, agents, tools, and setup instructions from one prompt | +| **๐Ÿค– App Agents** | Each app gets its own first-class agents with roles, prompts, data access, and approved tools | +| **๐Ÿงฐ Scoped Tool Generation** | Tools are generated per app and tied to explicit domains, collections, inputs, and integration grants | +| **๐Ÿ”Œ Self-Building Integrations** | Second creates connection requirements and human setup instructions only when the app needs them | +| **๐Ÿคน Multi-Agent Orchestration** | Run specialized agents in parallel across foreground, background, scheduled, and async workflows | +| **๐Ÿ”„ BYO Runtime** | Use Claude Code, Codex, OpenCode, or your own harness. Switch runtimes per app or message | +| **โšก Realtime Collaboration** | Live data, change streams, resumable streams, and optimistic updates keep teams and agents synced | +| **๐Ÿ‘ฅ Multiplayer Sessions** | Talk with agents, invite teammates into sessions, 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 | +| **๐Ÿ  Self-Hosted / On-Prem** | Deploy on your own infrastructure. Your Kubernetes 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 | @@ -264,8 +283,6 @@ And many more: | **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 @@ -282,31 +299,10 @@ 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 | - - - - +| **๐Ÿคน Multi-agent orchestration** | Multiple specialized agents per app, coordinated through shared app state | +| **โฒ๏ธ Long-running async work** | Scheduled jobs, periodic research, background runs, and resumable streams | +| **๐Ÿ—ƒ๏ธ Live data persistence** | Realtime DB with Change Streams; app data survives restarts and user churn | +| **๐Ÿงพ Governance and auditability** | Review flows, access checks, integration approvals, and searchable audit events | --- @@ -369,7 +365,7 @@ Every app's agent capabilities are declared, version-controlled, and approved: ## Self-Hosting -Second runs on your infrastructure: your k8s cluster, your VPC, your rules. +Second runs on your infrastructure: your Kubernetes cluster, your VPC, your rules. For full environment setup, see the [self-hosting docs](https://docs.second.so/self-hosting).