whatisgithub

What is talkamort?

prateekmedia/talkamort — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · vibe coderComplexity · 2/5Setup · moderate

In one sentence

Talkamort is a terminal based text adventure that uses an AI model to improvise a new science fiction story on every playthrough.

Mindmap

mindmap
  root((talkamort))
    What it does
      Improvised text adventure
      Retro terminal UI
      Type on narration
      Blip sound effects
    Tech stack
      TypeScript
      Node.js
      Codex SDK
    Use cases
      Play a new story each run
      Retro game aesthetics
      AI driven narrative
    How it works
      Single Codex thread
      Hidden mechanism per game
      Read only agent

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play a fresh, improvised science fiction text adventure directly in your terminal.

USE CASE 2

Explore how a persistent AI conversation thread can drive an interactive fiction game.

USE CASE 3

Customize the game with windowed mode or different sound styles while playing.

What is it built with?

TypeScriptNode.jsCodex

How does it compare?

prateekmedia/talkamort0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+ and a signed in Codex account before the game will run.

No license information stated in the README.

So what is it?

Talkamort is a small text adventure game that runs inside your terminal. Each time you play, it generates a brand new science fiction story on the fly, starting from a setting that feels ordinary before revealing a hidden twist through the choices you make. The look and feel is intentionally retro: black and neon colors, text that types itself onto the screen, and short blip sounds like the ones from old text heavy games. To play, you need Node.js version 18 or newer and an account with Codex, the AI system that writes the story as you go. After signing into Codex, you install the project's dependencies and either run it directly or build a local talkamort command you can launch from anywhere. Once inside the game, typing a help command shows you what you can do, and Ctrl+C lets you quit at any time. The game keeps a single running transcript in your terminal window. Nothing gets cleared as you play, your commands and the story's replies simply keep appending to what came before, so your terminal's normal scrollback holds your entire adventure. While the game is generating the next bit of story or revealing text on screen, your keyboard input is held back so a stray keystroke cannot slip into the wrong moment. Every new game picks a familiar setting and pairs it with a hidden science fiction idea, such as time distortion, parallel worlds, contact with aliens, artificial minds, or strange physics, but you only discover which one through playing. The game remembers your five most recent combinations so you do not see the same setup twice in a row. You can also start in windowed mode to keep your terminal history intact, turn off sound entirely, or switch between a few different sound styles while playing. Behind the scenes, each game is a single ongoing conversation with an AI model, which is given the opening rules and setting once and then simply receives your typed actions for every turn after that. This keeps track of characters, objects, and consequences as the story continues. The model is only allowed to write the story text, it cannot use any outside tools while playing.

Copy-paste prompts

Prompt 1
Explain how Talkamort keeps one persistent Codex thread going across an entire game session.
Prompt 2
Walk me through installing Node.js and Codex login so I can run talkamort locally.
Prompt 3
How does Talkamort avoid repeating the same setting and science fiction twist between games?
Prompt 4
Describe how Talkamort locks keyboard input while the story is being generated or revealed.

Frequently asked questions

What is talkamort?

Talkamort is a terminal based text adventure that uses an AI model to improvise a new science fiction story on every playthrough.

What language is talkamort written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Codex.

What license does talkamort use?

No license information stated in the README.

How hard is talkamort to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is talkamort for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.