Version 3.0 — now on npm

Write Interactive Fiction.
It's Easier Than You Think.

Sharpee is a modern platform for writing parser-based interactive fiction. Build rich, explorable worlds — and focus on the writing.

Sharpee 3.0 is the current stable release, available now on npm. Install the CLI with npm i -g @sharpee/devkit, then run sharpee init to start a new story.

Get Started

New in 3.0: The Chord Story Language

Sharpee 3.0 introduces Chord, a story language built for writers. Instead of TypeScript, you write a .story file that reads like the prose it produces:

create the brass hook
  aka hook, peg
  scenery, a supporter with capacity 1
  in the Cloakroom

  It's just a small brass hook, screwed to the wall.

Chord compiles to the same traits, behaviors, and phrases as the platform API — the classic Cloak of Darkness drops from 785 lines of TypeScript to under 100 lines of Chord. Meet the language.

The Book Is Here

The Sharpee Author and Developer Manual (v2.0.0 edition) teaches the whole platform by building one game, the Family Zoo, across 31 chapters: rooms, objects, puzzles, NPCs, timed events, scoring, a browser client, theming, and testing. Every listing was verified against the published packages by a first-time reader following the book literally, front to back, until a full run came back clean.

Read it online, or download the EPUB or PDF. Every code listing is also available on the snippets page.

Build Worlds Like Lego

Everything in your world is assembled from small, snap-together pieces called traits. A treasure chest? That's a container, an openable, and a lockable. A lantern? A light source and a switchable. You build exactly what you need — no more, no less.

Container Openable Lockable = Treasure Chest

Logic and Prose Stay Separate

When a player types a command, Sharpee handles the mechanics first — then turns the result into prose. Your story logic and your writing are separate concerns. Change how something reads without touching how it works, and vice versa. The 2.x line rebuilt this rendering layer around the phrase algebra: composable phrases that produce grammatical, article-correct prose from your world's own vocabulary.

Player types open chest World changes chest.isOpen Story says "You open it."

You focus on the world and the words. Sharpee handles the plumbing.