Skip to content

YujunZhou/tellonce / codex

tellonce

Verified

Use to view, explain, correct, delete or reorganize the user's saved preferences, or to record one by hand when automatic recording is off; learning and rule injection otherwise run automatically through Codex hooks.

FileKindSize
.codex-plugin/plugin.jsonconfig1.3 KB
SKILL.mdskill md12.0 KB
dashboard.shexecutablescript348 B
docs/CC_PARITY_MATRIX.mdmarkdown7.3 KB
docs/README.mdmarkdown3.4 KB
doctor.shexecutablescript345 B
hooks/hooks.jsonconfig714 B
hooks/posttooluse-deterministic-block.shexecutablescript2.0 KB
hooks/sessionstart-init.shexecutablescript1.9 KB
hooks/userpromptsubmit-dispatch.pyscript2.6 KB
hooks/userpromptsubmit-memory-upsert.shscript326 B
hooks/userpromptsubmit-pending-inject.shexecutablescript2.0 KB
hooks/userpromptsubmit-retrieve-inject.shexecutablescript3.1 KB
hooks/userpromptsubmit-shadow-alert-inject.shexecutablescript1.2 KB
install.shexecutablescript13.9 KB
shared_lib/_install_merge_settings.pyscript12.1 KB
shared_lib/_pt_hooks.txtmarkdown407 B
shared_lib/correction_interpretation.pyscript8.5 KB
shared_lib/detect_user_prefer.pyscript7.2 KB
shared_lib/deterministic_block.pyscript9.3 KB
shared_lib/event_obligations.pyscript19.8 KB
shared_lib/execution_support.pyscript75.8 KB
shared_lib/fingerprints.yamlconfig1.1 KB
shared_lib/learning_policy.pyscript4.6 KB
shared_lib/memory_judge.pyscript84.8 KB
shared_lib/memory_publication.pyscript14.9 KB
shared_lib/memory_runtime.pyscript12.2 KB
shared_lib/memory_store.pyscript99.6 KB
shared_lib/memory_upsert.pyscript57.1 KB
shared_lib/memory_upsert_hook.pyscript4.6 KB
shared_lib/model_requests.pyscript5.8 KB
shared_lib/path_config.pyscript13.3 KB
shared_lib/pending_queue_manager.pyscript23.4 KB
shared_lib/pt_platform.pyscript1.5 KB
shared_lib/redaction.pyscript3.4 KB
shared_lib/retrieve_inject.pyexecutablescript57.9 KB
shared_lib/rule_selection.pyscript18.9 KB
shared_lib/shadow_alert_inject.pyscript6.1 KB
shared_lib/training_memory.pyscript17.8 KB
shared_lib/transcript_adapter.pyscript13.7 KB
shared_lib/verify_compliance.pyexecutablescript24.5 KB
shared_lib/verify_retry_shadow.pyscript27.4 KB
tellonce_codex/__init__.pyscript52 B
tellonce_codex/__main__.pyscript49 B
tellonce_codex/cli.pyscript6.8 KB
tellonce_codex/codex_posttooluse_block.pyscript11.2 KB
tellonce_codex/dashboard.pyscript3.4 KB
tellonce_codex/doctor.pyscript10.9 KB
tellonce_codex/index.pyscript1.8 KB
tellonce_codex/install.pyscript3.1 KB
tellonce_codex/install_codex_hooks.pyscript15.1 KB
tellonce_codex/ledger.pyscript17.1 KB
tellonce_codex/memory.pyscript5.3 KB
tellonce_codex/migrate.pyscript1.3 KB
tellonce_codex/mode.pyscript2.3 KB
tellonce_codex/paths.pyscript8.6 KB
tellonce_codex/promote.pyscript4.4 KB
tellonce_codex/scan.pyscript2.6 KB
tellonce_codex/uninstall.pyscript1.7 KB
tellonce_codex/verify.pyscript5.3 KB
tellonce_codex/wrapper.pyscript12.0 KB
uninstall.shexecutablescript4.6 KB

docs/README.md

View on GitHub
# Codex Tellonce

Codex-native port of the corrected Claude Code `tellonce`.

Since 1.7.1, background automatic recording is enabled, using the current
platform CLI model on redacted user input. `memory_upsert.py disable-hooks` opts
out; existing explicit opt-out is retained. Hard blocking remains opt-in.

## User Flow

The external UX should stay simple:

```bash
git clone <repo> ~/.codex/skills/tellonce
cd /path/to/project
bash ~/.codex/skills/tellonce/codex/install.sh
bash ~/.codex/skills/tellonce/codex/doctor.sh
```

> The Codex installer lives under `codex/` — the repo-root `install.sh` is the
> Claude Code variant and would register Claude Code hooks instead.

**One-time hook trust approval (required).** Codex trusts hooks by a hash of
their exact definition and **silently skips** untrusted ones — no error, no
log. After install (and after ANY later change to the hook definitions,
including re-running `install.sh`, which rewrites/re-orders them), start an
interactive Codex session and approve the tellonce hook entries when Codex
prompts for review. Until then the hooks do not fire at all. For one-off
non-interactive verification: `codex exec --dangerously-bypass-hook-trust ...`.

Internally the package records a project-local audit ledger and uses wrapper-based verification where possible. Users do not need to choose internal modes during normal install.

## Modes

- `audit_only`: default. Records scans and warnings; does not claim hard enforcement.
- `wrapper`: checks output produced through `tellonce_codex exec`.
- `blocking`: opt-in hard-block layer on PostToolUse (ships with no built-in
  rules, so on its own it blocks nothing until you add rules).

(The top-level README's `observe → enforce → full` naming maps to
`audit_only → blocking` here; Codex has no shadow-judge mode yet.)

## Current V1 Capabilities

- Project registration under `.codex/tellonce/`.
- `mode.json` as mode authority.
- Append-only `events.jsonl` with centralized redaction.
- Scan events for preference/pitfall/friction/none.
- Explicit memory promotion with intent and commit events.
- Active memory index rebuilt from committed memory.
- Doctor status line and private path audit.
- Conservative install/uninstall.
- Wrapper run capture and verifier verdict.
- Migration preview that does not write active memory.
- Skill package wrapper scripts.

## Non-Guarantees

- Native interactive Codex text is advisory unless routed through the wrapper.
- Plain `codex`, IDE integrations, and web Codex can bypass wrapper checks.
- Hard blocking is not default.
- Shadow judge is not enabled by default and must not require Claude CLI.

## Claude Code Parity

See `CC_PARITY_MATRIX.md`. No Claude Code capability should be dropped; features may be staged internally but must keep a parity row and a replacement path.

## Uninstall

```bash
# Per-project disable only (keeps the global runtime + ~/.codex/hooks.json entries
# so other projects keep working):
bash ~/.codex/skills/tellonce/codex/uninstall.sh

# FULL uninstall — also removes the hook registrations from ~/.codex/hooks.json
# (so the hooks stop firing everywhere) and the global runtime:
bash ~/.codex/skills/tellonce/codex/uninstall.sh --purge-hooks --purge-skill
```

> Note: the hooks keep firing as long as they're registered in
> `~/.codex/hooks.json`. The default uninstall intentionally keeps that
> registration (the global runtime is shared across projects); pass
> `--purge-hooks` to remove it and fully stop the hooks.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall