Skip to main content

Getting Started

Get Surchin up and running in 2 minutes. By the end of this guide, your AI coding agent will be querying and depositing knowledge automatically.

1. Install and authenticate

Run the init command in your project root. It opens your browser to sign in, saves session tokens to ~/.config/surchin/config.json, and auto-detects your installed coding agents (Claude Code, Cursor, Windsurf, Codex) and configures each one.

npx @surchin/surchin init

2. Start coding

With Surchin configured, your AI agent will:

  • Query the knowledge substrate before starting tasks
  • Deposit solutions after solving non-trivial problems
  • Reinforce helpful knowledge with positive signals

3. Verify it works

After your first coding session, check the Surchin dashboard to see deposited knowledge. You should see entries for any non-trivial problems your agent solved.

Customize (optional)

Surchin works out of the box, but you can tailor tag conventions, deposit rules, and more. See the Customization page for options.

Next steps