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

tellonce_codex/install.py

View on GitHub
from __future__ import annotations

import os
import sys
from dataclasses import dataclass
from pathlib import Path

from .ledger import secure_write_text
from .paths import Registration, register_project


@dataclass(frozen=True)
class InstallRecord:
    state_root: Path
    registration: Registration
    hooks_registered: bool = False


def _try_register_global_hooks() -> tuple[bool, str]:
    """Auto-register PT hooks in ~/.codex/hooks.json if the global
    runtime layout exists. Idempotent — re-running is safe (skipped =
    "already registered").

    Returns (registered, message). registered=True iff the call ran without
    error AND the hooks dir exists. message is for the caller to surface.
    """
    skill_dir = Path.home() / ".codex" / "skills" / "tellonce"
    # Mirror codex/install.sh's clone detection: when the user's git clone
    # occupies the default path, the generated runtime (with the CODEX hook
    # scripts) lives in the sibling -runtime dir. The clone's root hooks/
    # holds the Claude Code variant's hooks — registering that dir here would
    # create phantom entries pointing at scripts that don't exist there.
    # `.git` covers clones; the codex/install.sh marker covers repos COPIED
    # there without git metadata (the generated runtime layout has no codex/).
    if (skill_dir / ".git").exists() or (skill_dir / "codex" / "install.sh").exists():
        skill_dir = Path.home() / ".codex" / "skills" / "tellonce-runtime"
    hooks_dir = skill_dir / "hooks"
    hooks_json = Path.home() / ".codex" / "hooks.json"
    if not hooks_dir.is_dir():
        return False, (
            f"⚠ ~/.codex/skills/tellonce/hooks/ not present — global "
            f"runtime not installed yet. Run `bash codex/install.sh` once to "
            f"deploy the runtime + hooks. Current call only initialized "
            f"per-project state."
        )
    try:
        from .install_codex_hooks import cmd_add
        cmd_add(str(hooks_json), str(hooks_dir))
        return True, f"✓ hooks registered in {hooks_json}"
    except Exception as e:
        return False, f"⚠ hook registration failed: {type(e).__name__}: {e}"


def install(project_root: Path, register_hooks: bool = True) -> InstallRecord:
    disabled_marker = project_root.resolve() / ".codex" / "tellonce.disabled"
    try:
        disabled_marker.unlink()
    except OSError:
        pass
    registration = register_project(project_root)
    state = registration.state_root
    secure_write_text(state / "install_record.json", '{"status":"installed"}\n')
    secure_write_text(state / "managed_runtime.txt", "tellonce_codex runtime\n")

    hooks_registered = False
    if register_hooks:
        hooks_registered, msg = _try_register_global_hooks()
        # Surface the message so users running `tellonce_codex install`
        # bare (without bash install.sh wrapping it) see what happened.
        try:
            sys.stderr.write(msg + "\n")
        except Exception:
            pass

    return InstallRecord(
        state_root=state,
        registration=registration,
        hooks_registered=hooks_registered,
    )
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