Starter workspace for Codex.

Canonical repo: jxnl/personal-monorepo-template.

This template gives Codex a place to look before it acts:

• projects/ for active work
• experiments/ for short spikes
• people/ for collaborators and agents
• .codex/skills/ for repo-local skills

Install the current packaged version:

curl -L https://github.com/jxnl/personal-monorepo-template/releases/download/v0.1.1/personal-monorepo-template-v0.1.1.zip -o /tmp/personal-monorepo-template-v0.1.1.zip
ditto -x -k /tmp/personal-monorepo-template-v0.1.1.zip ~

That creates:

~/personal-monorepo

The zip is created by the Package template GitHub Action when a version tag is pushed.

1. Open Codex.
2. Install the plugins you actually use.
3. Create a new Codex project rooted at ~/personal-monorepo.
4. Create a new thread in that project.
5. Say:

$onboard me

Install plugins before onboarding so Assistant can read the right context.

Start with the tools where your work happens:

• Assistant
• Gmail or Outlook Email
• Google Calendar or Outlook Calendar
• Google Drive, Notion, Documents, Spreadsheets, Presentations, or PDF
• Slack or Teams
• GitHub, Linear, or Notion for project tracking
• Browser
• Chrome
• Computer Use

For Chrome workflows, install the Chrome plugin and the Codex Chrome Extension.

Onboarding should explain what it is checking before it checks it.

It should:

• read the workspace
• ask what projects exist and what matters
• ask who Codex should know about
• check whether useful plugins are missing
• offer thread automations for recurring checks
• offer a daily update monitor, people monitor, and project monitors where useful
• offer shared-memory setup if you want durable context outside one chat

Assistant should ask before sending messages, changing meetings, editing shared docs, creating automations, creating, pinning, renaming, or looping threads, installing plugins, or writing shared memory.

Repo-local skills live under .codex/skills/.

Useful starting points:

• onboarding: first setup
• assistant: ongoing work support after onboarding
• loop: recurring checks on a thread
• new-project: create a project or experiment
• new-person: create a person note

• projects/: long-lived work
• experiments/: short-lived spikes
• people/: notes about people or agents
• .codex/: skills, plugin metadata, and assets
• templates/: starter files
• tests/: checks for template integrity