Skip to content

An open spec for work & personal knowledge bases

An opinionated set of types, relationships, and lifecycle states.

Types

Eight defaults for real-life knowledge

Portent starts with a small, opinionated type system so you can stop inventing categories from scratch.

PORT types describe actionable work: Projects, Operations, Responsibilities, and Tasks. ENTP types describe context and memory: Events, Notes, Topics, and People.

Explore types
PORT and ENTP type groups in Portent
Relationships

Connect things by how they are useful

Portent models knowledge as a graph. Instead of choosing one folder, you connect each item to things that explain why it matters.

The default relationships are deliberately simple. Use belongs_to for ownership and related_to for looser context, then add more specific ones only when your system needs them.

Explore relationships
Belongs to and related to relationships between Portent types
Lifecycle

Keep capture separate from organization

Portent treats every piece of information as moving through a simple lifecycle. Capture first so nothing is lost, organize when you can say what it is and what it is useful for, archive when it has served its purpose.

This keeps the workspace clean without making capture expensive.

Explore lifecycle
Capture, organize, and archive lifecycle steps
Made with care

Built by Luca, for Luca

Portent ideas are extracted from how I use Tolaria, and both are the product of the learnings of 15 years of engineering + content creation work.

Luca

Hey, I am Luca

Founder & Author of Refactoring

Portent is born from 5 years of full-time writing at Refactoring, 10 as CTO of a high-growth startup, and my PhD research on database models. Along the way, I amassed 10,000 notes on various tools' workspaces, learned a lot about knowledge mgmt, productivity, and working well with AI.

5 yearsfull-time writing
10 yearsstartup CTO work
10,000notes across tools

Stay in the loop.

Subscribe to the Refactoring newsletter for updates on Portent, Tolaria, and behind-the-scenes of building in public.

Subscribe to Refactoring170,000+ engineers already subscribed

An open vocabulary for portable knowledge systems.