Superlist Assist for Codex

Superlist Assist is a Codex plugin for capturing tasks, showing a focused daily brief, recapping recent work, and tidying stale tasks through the official Superlist connection.

Workflows

Ask naturally or invoke $superlist-assist explicitly:

Intent	Example
Set up	$superlist-assist Set up Superlist Assist
Capture	$superlist-assist Capture "Book dentist" next Thursday
Brief	$superlist-assist Show my daily brief
Recap	$superlist-assist Recap last week
Tidy	$superlist-assist Tidy stale tasks
Configure	$superlist-assist Change my brief time

tidy replaces the former /review name so it does not collide with Codex's built-in source-code review command.

On first use, the skill detects that no configuration exists and starts its onboarding flow. No lifecycle hook is required.

Package

.codex-plugin/plugin.json
.agents/plugins/marketplace.json
.app.json
skills/superlist-assist/
  SKILL.md
  agents/openai.yaml
  assets/config.example.json
  references/
  scripts/state.py
tests/test_runtime.py

The plugin references Superlist's registered app connection. ChatGPT and Codex handle OAuth authentication. User configuration and state live outside the installed plugin cache so reinstalling the plugin does not erase them.

Scheduling

During onboarding, a user may choose a time for:

• a daily brief
• a weekly tidy on their chosen review day

When Codex automation management is available, the skill creates two scheduled thread tasks and records their IDs. If it is unavailable or the user chooses manual mode, every workflow remains available on request. The plugin does not depend on hooks or on Codex being opened at session start.

Install for testing

Add this repository as a Codex marketplace, then install the plugin:

/Applications/ChatGPT.app/Contents/Resources/codex \
  plugin marketplace add superlistapp/superlist-assist-codex

/Applications/ChatGPT.app/Contents/Resources/codex \
  plugin add superlist-assist@superlist-experimental

Then:

1. Open Codex Desktop.
2. Authenticate Superlist if prompted.
3. Start a fresh task so Codex loads the newly installed skill.
4. Ask: Set up Superlist Assist.

For a private workspace test, the plugin owner can instead open the plugin in Codex Desktop, choose Share, and add colleagues or copy the workspace link.

Test checklist

Use a non-production Superlist workspace where possible.

1. Setup triggers onboarding and creates the selected lists.
2. The final onboarding question asks: “What are your 3 main goals for next week?”
3. Capture creates one task in the correct list without duplicating it when the request is repeated.
4. Brief shows today's tasks and can accept a follow-up capture.
5. Recap works for a named period such as “last week”.
6. Tidy shows stale tasks and confirms before deletion.
7. Configuration can pause/resume the brief and change its time or review day.
8. Scheduled brief and tidy appear in Codex when scheduling is enabled.

Development

Run the repository tests:

python3 -m unittest discover -s tests -v

Validate the skill and plugin with the bundled skill-creator and plugin-creator validators before publishing an update.

List and task titles are always used verbatim. Never synthesize or store a separate emoji field.