codex-mcp-eraser 0.0.1__py3-none-any.whl

codex_mcp_eraser/__init__.py

@@ -0,0 +1,3 @@
+"""Remove user-configured MCP servers and hooks from Codex CLI."""
+
+__version__ = '0.0.1'

codex_mcp_eraser/__main__.py

@@ -0,0 +1,8 @@
+"""Run codex-mcp-eraser as a module."""
+import sys
+
+from .cli import main
+
+
+if __name__ == '__main__':
+    sys.exit(main())

codex_mcp_eraser/cli.py

@@ -0,0 +1,153 @@
+"""Command-line interface for safely removing Codex MCP servers and hooks."""
+import argparse
+import datetime as dt
+import os
+from pathlib import Path
+import re
+import shutil
+import sys
+import tempfile
+import tomllib
+
+
+HEADER = re.compile(r'^\s*\[\[?\s*(.*?)\s*\]\]?\s*(?:#.*)?$')
+
+
+def toml_path(header):
+    """Divide TOML table paths while respecting quoted segments."""
+    result, part, quote, escape = [], '', None, False
+    for char in header:
+        if escape:
+            part += char
+            escape = False
+        elif quote == '"' and char == '\\':
+            part += char
+            escape = True
+        elif quote:
+            if char == quote:
+                quote = None
+            else:
+                part += char
+        elif char in ('"', "'"):
+            quote = char
+        elif char == '.':
+            result.append(part.strip())
+            part = ''
+        else:
+            part += char
+    if quote:
+        raise ValueError('Cabecera TOML con comillas incompletas')
+    result.append(part.strip())
+    return result
+
+
+def transform(content):
+    original = tomllib.loads(content)
+    lines = content.splitlines(keepends=True)
+    keep, section, removed = [], (), set()
+    # Table headers are the only safe way to selectively edit these settings.
+    for line in lines:
+        match = HEADER.match(line.rstrip('\r\n'))
+        if match:
+            section = tuple(toml_path(match.group(1)))
+        drop = bool(section and section[0] in ('mcp_servers', 'hooks'))
+        if drop:
+            removed.add(section[0])
+        else:
+            keep.append(line)
+    result = ''.join(keep)
+    updated = tomllib.loads(result)
+    # Stop without changes if an unsupported representation remains.
+    if 'mcp_servers' in updated or 'hooks' in updated:
+        raise ValueError('Hay MCP/hooks fuera de tablas TOML editables; se requiere revisión manual')
+    if any(key in original for key in ('mcp_servers', 'hooks')) and not removed:
+        raise ValueError('No se localizaron tablas de MCP/hooks para eliminar con seguridad')
+    return result, removed
+
+
+def atomic_write(path, content):
+    stat = path.stat()
+    with tempfile.NamedTemporaryFile('w', encoding='utf-8', dir=path.parent,
+                                     prefix='.codex-reset-', delete=False) as tmp:
+        tmp.write(content)
+        tmp_path = Path(tmp.name)
+    try:
+        os.chmod(tmp_path, stat.st_mode & 0o777)
+        os.replace(tmp_path, path)
+    finally:
+        if tmp_path.exists():
+            tmp_path.unlink()
+
+
+def _run():
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--dry-run', action='store_true', help='Solo muestra los cambios')
+    parser.add_argument('--apply', action='store_true', help='Aplica cambios tras confirmar')
+    parser.add_argument('--yes', action='store_true', help='Omite la confirmación (requiere --apply)')
+    parser.add_argument('--project', type=Path, help='Incluye .codex/ del proyecto indicado')
+    parser.add_argument('--codex-home', type=Path,
+                        default=Path(os.environ.get('CODEX_HOME', str(Path.home() / '.codex'))),
+                        help='Directorio de configuración del usuario de Codex')
+    args = parser.parse_args()
+    if args.apply and args.dry_run:
+        parser.error('--apply y --dry-run son incompatibles')
+    if args.yes and not args.apply:
+        parser.error('--yes requiere --apply')
+
+    dirs = [args.codex_home.expanduser().resolve()]
+    if args.project:
+        dirs.append((args.project.expanduser().resolve() / '.codex'))
+    targets = []
+    print('Modo:', 'APLICAR' if args.apply else 'DRY-RUN (sin cambios)')
+    for directory in dict.fromkeys(dirs):
+        config = directory / 'config.toml'
+        hooks = directory / 'hooks.json'
+        if config.is_symlink() or hooks.is_symlink():
+            raise RuntimeError(f'Enlaces simbólicos no admitidos: {directory}')
+        if config.is_file():
+            content = config.read_text(encoding='utf-8')
+            changed, sections = transform(content)
+            if changed != content:
+                targets.append((config, changed))
+                print(f'  EDITAR {config}: quitar tablas {", ".join(sorted(sections))}')
+        if hooks.is_file():
+            targets.append((hooks, None))
+            print(f'  RETIRAR {hooks}: hooks de usuario/proyecto')
+    if not targets:
+        print('No hay cambios en las ubicaciones revisadas.')
+        return 0
+    if not args.apply:
+        print('Para ejecutar: codex-mcp-eraser --apply')
+        return 0
+    if not args.yes:
+        answer = input('Escribe RESTABLECER para continuar: ')
+        if answer != 'RESTABLECER':
+            print('Cancelado, sin cambios.')
+            return 1
+    stamp = dt.datetime.now().strftime('%Y%m%d-%H%M%S-%f')
+    # Keep backups under Codex home, away from external credentials.
+    backup = dirs[0] / 'backups' / f'mcp-hooks-reset-{stamp}'
+    backup.mkdir(parents=True, mode=0o700, exist_ok=False)
+    os.chmod(backup, 0o700)
+    for i, (path, _) in enumerate(targets):
+        dst = backup / f'{i:02d}-{path.name}'
+        shutil.copy2(path, dst)
+        os.chmod(dst, 0o600)
+        print(f'  RESPALDO {path} -> {dst}')
+    for path, content in targets:
+        if content is None:
+            path.unlink()
+        else:
+            atomic_write(path, content)
+    print(f'Listo. Copia de seguridad: {backup}')
+    print('Reinicia Codex. Los hooks/MCP de plugins o configuración administrada no se modificaron.')
+    return 0
+
+
+def main():
+    """Run the CLI and convert operational errors into a concise exit status."""
+    try:
+        return _run()
+    except (OSError, ValueError, RuntimeError, tomllib.TOMLDecodeError) as exc:
+        print(f'ERROR: {exc}', file=sys.stderr)
+        return 2

codex_mcp_eraser-0.0.1.dist-info/METADATA

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: codex-mcp-eraser
+Version: 0.0.1
+Summary: Safely remove user-configured MCP servers and hooks from Codex CLI
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# codex-mcp-eraser
+
+A Python command-line tool that removes user-configured MCP server tables and
+hooks from Codex CLI configuration. It does not modify plugin settings or
+managed policies.
+
+Requires Python 3.11 or later.
+
+## Install
+
+```bash
+python -m pip install codex-mcp-eraser
+```
+
+## Use
+
+The default is a dry run. Review the paths and changes before applying them:
+
+```bash
+codex-mcp-eraser
+codex-mcp-eraser --apply
+```
+
+Use `--yes` with `--apply` to skip the confirmation prompt. `--project PATH`
+also checks that project's `.codex/` directory. `--codex-home PATH` overrides
+the user configuration directory; otherwise `CODEX_HOME` or `~/.codex` is used.
+
+Before changing or removing files, the tool creates a permission-restricted
+backup under the Codex home directory.

codex_mcp_eraser-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+codex_mcp_eraser/__init__.py,sha256=dwvLl3zJkCCUUSEQCXR6j6qpxK_PNjdePo4pqLCymik,89
+codex_mcp_eraser/__main__.py,sha256=SCMXvbQ9yMHeNPEOCvQhybPG6lLGuwaqiQjN3wVeWlc,123
+codex_mcp_eraser/cli.py,sha256=M6O_7-8zvoyRXBO2mzyBcJfw5krfhnShX9JRlmU2Ub8,5816
+codex_mcp_eraser-0.0.1.dist-info/METADATA,sha256=G0Jn-6A15CpHF3G1TElvgk3XgQIBSOdWkZi15vf_alM,1314
+codex_mcp_eraser-0.0.1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+codex_mcp_eraser-0.0.1.dist-info/entry_points.txt,sha256=qvI2QuqHQICIXdwYNc4Nwv_zPdkz7cXI9xVqg2BFXwA,63
+codex_mcp_eraser-0.0.1.dist-info/top_level.txt,sha256=v3IUS2m0NAmC2aSIKQnAJRc8ab5N5rUR02ZuyfidsQw,17
+codex_mcp_eraser-0.0.1.dist-info/RECORD,,

codex_mcp_eraser-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codex_mcp_eraser-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+codex-mcp-eraser = codex_mcp_eraser.cli:main

codex_mcp_eraser-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+codex_mcp_eraser