---
name: project
description: Capture project context as a memory in brain/memory/projects/ (active projects are compiled into BRAIN.md)
---
<!-- generated by tools/build-codex-plugin.js from plugin/; edit the source there, not this file -->

> Host: Codex CLI, through the `agenticos` plugin. Invoke as `$agenticos:project`. `<plugin root>` is the plugin's folder, two levels above the folder that holds this SKILL.md; the `aos` launcher is `<plugin root>/bin/aos`. The tools of the `agenticos` MCP server are named `mcp__agenticos__<tool>`.

Save this project context: **the text the user wrote after `$agenticos:project`**

Vault: the `vault` value in `${CLAUDE_CONFIG_DIR:-~/.claude}/agenticos.json`.

1. Parse `the text the user wrote after `$agenticos:project``: the first token is the project name (kebab-case); the rest is the context.
2. If `<vault>/brain/memory/projects/<project-name>.md` exists: add a dated bullet under `## Updates` and bump `updated:`. Otherwise create it:
```
---
type: memory
tags: [memory/projects, status/active]
created: <today>
updated: <today>
---

# <Project Name>

## Summary
*(one line)*

## Context
<the text from the text the user wrote after `$agenticos:project`>

## Updates
- <today>: <text>
```
3. If new, add `- [<Project Name>](brain/memory/projects/<project-name>.md) — <one line>` under `## Project` in `<vault>/MEMORY.md`.
4. Do not hand-edit `brain/_index/BRAIN.md`; it is compiled. `status/active` in the frontmatter is what puts the project into `## Active context`. To surface it immediately run `aos build-brain-md` via Bash (fallback: `sh "<plugin root>/bin/aos" build-brain-md`).
5. Confirm in one line.