Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.second.so/llms.txt

Use this file to discover all available pages before exploring further.

Contributions are welcome — whether it’s a bug fix, a feature, or a documentation improvement.

​
Getting started

Follow the Quickstart developer setup to get the app running locally. Once .second-dev.txt contains a url= value you can open in the browser, you’re ready to go.

​
Before opening a PR

Make sure lint and build pass: 
npm run typecheck
npm --prefix apps/web run lint
npm --prefix apps/web run build
npm --prefix apps/worker run typecheck

​
Guidelines

  • One concern per PR — keep changes focused and reviewable.
  • Preserve workspace isolation — if you’re touching API routes or repositories, make sure workspaceId scoping is maintained.
  • Bridge layer changes — if you modify worker-bridge.ts, test with a real agent session to verify tool calls and streaming work end to end.
  • No provider-specific details — don’t add private auth provider implementation details to OSS code or docs.
  • Update docs — if your change affects behavior or configuration, update the relevant doc page.

​
Reporting bugs

When filing an issue, include:
  • What you expected to happen
  • What actually happened
  • Steps to reproduce
  • Environment details: SECOND_AUTH_MODE, browser, and whether you’re using npm run dev or Docker