Documentation

Comment trigger

Write a Notion comment starting with a trigger prefix on any task page connected to the integration.

Trigger	Model	Example
`#claude`	Opus (default)	`#claude hva er status?`
`#opus`	Opus	`#opus analyser denne koden`
`#sonnet`	Sonnet (faster, cheaper)	`#sonnet gi et kort svar`
`#new`	Opus	`#new start fra scratch`

Claude svarer som en ny kommentar i samme tråd. Fortsett samtalen med en ny trigger-kommentar — historikken følger med. Bruk #new for å starte en helt ny sesjon (sletter cache og historikk).

Context Claude gets

Source	Always?	Details
Personal memory	Yes	Cloned from personal-memory repo, reads MEMORY.md
Page body	Yes	Prompt property or page block content
Entity context	Yes	Names, types, URLs of related entities
Conversation history	Yes	All prior comments tagged [Bruker]/[Claude]
Entity repo	If available	Cloned if entity has Type=Repository or GitHub URL

API endpoints

Method	Path	Auth	Description
POST	`/run`	API key	Trigger code generation from Notion task
POST	`/run-manual`	API key	Direct trigger with repo + prompt
POST	`/ingest`	API key	Update personal-memory from Notion task
POST	`/comment`	API key	Answer question (direct API call)
POST	`/webhook/notion`	HMAC	Notion webhook for comment.created
GET	`/thread/:jobId`	API key	Job chain thread data
POST	`/reply/:jobId`	API key	Reply to continue a job
POST	`/review/:jobId`	API key	Trigger code review on PR
POST	`/merge/:jobId`	API key	Guarded merge of PR
GET	`/status/:jobId`	API key	Job status + log tail
GET	`/jobs`	API key	List all jobs
GET	`/health`	Public	Health check

POST /run

POST /run
Content-Type: application/json
X-API-Key: <key>

{"pageId": "notion-page-uuid"}

Fetches task from Notion, clones entity repo, runs Claude, creates PR.

POST /comment

POST /comment
Content-Type: application/json
X-API-Key: <key>

{"pageId": "notion-page-uuid", "comment": "optional override"}

Same as webhook trigger but via API. If comment is omitted, uses latest Notion comment.

Webhook setup

Enable Read comments capability on Notion integration
Create webhook subscription — URL: https://runner.nettsmed.dev/webhook/notion
Copy verification_token from server logs → paste in Notion verify dialog
Set NOTION_WEBHOOK_SECRET=<token> in .env
Restart service

Known gotchas

Notion signature prefix: X-Notion-Signature uses sha256=<hex> format, not raw hex.

Nginx routing: New endpoints need explicit location blocks in Plesk nginx config.