git404hub

what is codex_goal_hook fr?

last-emo-boy/codex_goal_hook — explained in plain English

Analysis updated 2026-05-18

12PowerShellAudience · developerComplexity · 2/5Setup · moderate

tl;dr

A PowerShell installer that adds persistent goal tracking to OpenAI's Codex coding assistant so that long-running tasks survive session restarts by storing context, memory, and decisions as plain text files in your workspace.

vibe map

mindmap
  root((codex_goal_hook))
    What it does
      Persistent goals
      Session memory
      Hook integration
    Files stored
      context.md
      memory.md
      decisions.md
    Tech Stack
      PowerShell
      Node.js
      npm
    Use Cases
      Long-running tasks
      Architecture mapping
      Decision tracking

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 make with this?

VIBE 1

Keep a running task context that Codex automatically reloads at the start of every new session

VIBE 2

Track architecture decisions and per-turn notes as plain editable text files inside your project folder

VIBE 3

Use the /goal command in Codex to activate goal mode and anchor a session to a specific long-running objective

what's the stack?

PowerShellNode.jsnpm

how it stacks up fr

last-emo-boy/codex_goal_hookalugoju/autopilot-provisioning-frameworkelnora-ai/elnora-ai-agent-hackathon-starter-kit
Stars121212
LanguagePowerShellPowerShellPowerShell
Setup difficultymoderatehardmoderate
Complexity2/54/5
Audiencedeveloperops devopsvibe coder

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node.js 18 or later and OpenAI Codex with hooks support enabled, targets Windows environments.

No license information was mentioned in the explanation.

in plain english

This repository provides a skill and installer for OpenAI's Codex coding assistant that adds persistent goal tracking across sessions. The core problem it addresses is that AI coding sessions normally have no memory between restarts: if you set a long-running task (map the architecture, find fragile areas, make an improvement, add tests), that context is lost when you close and reopen Codex. Goal-hook works around this by maintaining a folder called .codex-goal/ in your workspace that stores the ongoing goal, accumulated memory, decisions made, and per-turn notes as plain files on disk. When Codex starts a new session, a hook script reads those files and loads the stored context back in, so the assistant picks up where it left off. The hook integrates with Codex's hooks system, which allows external scripts to run at defined points in the session lifecycle such as when a session starts. Installation uses npm and PowerShell. The installer writes the necessary hook configuration into Codex's config file automatically when the --apply-config flag is passed. After restarting Codex, a /goal command becomes available that activates goal-mode for the current task. The runtime files it creates (context.md, memory.md, decisions.md, and others) are plain text and can be read or edited by hand. The project targets Windows environments given its reliance on PowerShell, though the README includes a brief note referencing a Linux community forum. Node.js 18 or later is required alongside Codex with hooks support.

prompts (copy fr)

prompt 1
How do I install codex_goal_hook on Windows using npm and apply its config with the --apply-config flag?
prompt 2
What plain text files does codex_goal_hook create in .codex-goal/ and how can I manually edit them to steer the next session?
prompt 3
Walk me through the full flow from installing codex_goal_hook to restarting Codex and using the /goal command for the first time.
prompt 4
How does the codex_goal_hook startup script load stored context back into Codex at the beginning of a new session?

Frequently asked questions

what is codex_goal_hook fr?

A PowerShell installer that adds persistent goal tracking to OpenAI's Codex coding assistant so that long-running tasks survive session restarts by storing context, memory, and decisions as plain text files in your workspace.

What language is codex_goal_hook written in?

Mainly PowerShell. The stack also includes PowerShell, Node.js, npm.

What license does codex_goal_hook use?

No license information was mentioned in the explanation.

How hard is codex_goal_hook to set up?

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

Who is codex_goal_hook for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.