Pointsman documentation

Pointsman is an open-source decision service. Your systems send it a case, something to decide, for example a report of a closed road or a new pull request. Pointsman asks an AI model fixed questions, looks up facts in data, and applies rules that people wrote. The answer is an action. When it is not sure, a person checks the case. Every decision is recorded.

New here? Read How a decision is made, then try Your first profile.

Tutorial

• Your first profile: run Pointsman on your computer, write a profile, and decide with it.

How-to guides

• Write a profile with an AI assistant
• Deploy Pointsman, and rotate its API tokens
• Review pull requests with Pointsman

Reference

• Profile format
• Fact types, HTTP API and MCP tools, generated from the code
• GitHub connector

Explanation

• How a decision is made: questions, facts, rules and people, missing facts, and how Pointsman is built
• Security: what Pointsman protects, and against whom

About

• About this site: who runs it, the licence, privacy
• AI and agents: how an AI assistant uses Pointsman, and llms.txt

Notes for people who work on the engine, design notes and plans are in the repository, not on this site.