Quick Start
You want IntentText working in 5 minutes. Here's how.
Install
npm install @intenttext/core
Or use the CLI globally:
npm install -g intenttext
Write your first .it file
Create hello.it:
title: Project Kickoff
summary: Planning meeting notes for Atlas project
section: Decisions
text: Launch date confirmed for June 15
text: Budget approved at USD 180,000 | weight: bold
section: Tasks
task: Finalize vendor contracts | owner: Sarah | due: 2026-04-15
task: Set up staging environment | owner: Dev Team | due: 2026-04-20
task: Draft press release | owner: Marketing | due: 2026-05-01
section: Next Steps
deadline: Vendor selection complete | date: 2026-04-10 | consequence: Delays launch
Parse it
npx intenttext hello.it
You get structured JSON — every block typed, every property extracted.
Render to HTML
npx intenttext hello.it --html
Clean, styled HTML. Add a theme:
npx intenttext hello.it --html --theme corporate
Query it
Find all tasks owned by Sarah:
npx intenttext hello.it --query "type=task owner=Sarah"
Find all deadlines:
npx intenttext hello.it --query "type=deadline"
Use in code
import { parseIntentText, renderHTML } from "@intenttext/core";
const source = `
title: Quick Example
text: This is structured text.
task: Review document | owner: Ahmed | due: 2026-04-01
`;
const doc = parseIntentText(source);
const html = renderHTML(doc);
// Query blocks
const tasks = doc.blocks.filter((b) => b.type === "task");
console.log(tasks[0].properties.owner); // "Ahmed"
What's next
You've parsed, rendered, and queried. Now understand the model: