joedefen/memfo

No problems traced to this repository code in these checks.

Reviewed as expected for a test run: attempted writes that failed, so nothing was written.

OSV scanned supported lockfiles; unpinned dependencies and unsupported formats are outside this check.

A short run cannot establish that code is safe.

Connections show IP addresses; proxies can hide the final hostname.

Tracing covers dispatched commands and their children, not the whole OS; guest root can interfere with tracing.

Full safety evidence →

• Displays system /proc/meminfo values.: Real input produced the expected result: MemTotal

  Source: `memfo` is a viewer for `/proc/meminfo` that shows its data:

  Input: Run interactively and quit.

  Expected: MemTotal is visible.

  Command: /usr/bin/script -q -c <guest-path> /dev/null

  Observed: …MemTotal  3,487.3 MemAvailable (0q(0qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq(B(B(0(B 2,975.2 MemFree 25.9 Buffers 677.4 Cached 284.4 Active 474.1 Inactive 67.8 Active(anon) 474.1 Inactive(file) 29.8 Unevictable 26.8 Mlocked 0.3 Dirty 85.2 AnonPages 63.0 Mapped 3.9 Shmem 39.6 KReclaimable 88.7 Slab 39.6

Examples

• Start the interactive memory viewer and quit.: command completed successfully

  Source: README.md / Quick Start

  Input: q

  Expected: Memory rows include MemTotal.

  Command: /usr/bin/script -q -c <guest-path> /dev/null

  Observed: ;6H 25.9 Buffers 677.4 Cached 284.5 Active 474.2 Inactive 67.8 Active(anon) 474.2 Inactive(file) 29.8 Unevictable 26.8 Mlocked 0.3 Dirty 85.1 AnonPages 63.0 Mapped 3.9 Shmem 39.6 KReclaimable 88.7 Slab 39.6 SReclaimable 49.1 SUnreclaim 2.6 PageTables  1,957.6 CommitLimit(BExiting memfo application. [?1l>[?12l[?25h[?1049l [?1l>

Local or hosted: local

Interactive /proc/meminfo monitor

pwd; rg --files -g 'README*' -g 'pyproject.toml' -g 'package.json' -g 'requirements*.txt' -g 'AGENTS.md' -g '*.toml' -g '*.yaml' -g '*.yml' | head -80; python3 --version; git status --short; sed -n '1,240p' README.md
ls -la; find . -maxdepth 2 -type f -print | head -100; command -v pipx || true; command -v pip || true; command -v memfo || true; python3 -m pip --version; sed -n '1,240p'
cat pyproject.toml; id; command -v sudo; command -v apt-get; cat .coldpass/* 2>/dev/null
python3 -m pip install --user pipx; python3 -m pipx --version
sudo -n apt-get -o DPkg::Lock::Timeout=300 update && sudo -n apt-get -o DPkg::Lock::Timeout=300 install -y pipx python3-venv
pipx install memfo
sed -n '1,220p' memfo/main.py; <guest-path> --help; tail -80 README.md
TERM=xterm script -q -c '<guest-path>' /dev/null <<'EOF'
?
q
EOF
mkdir -p .coldpass; cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["<guest-path>"],"cwd":"<guest-path>","env":{"TERM":"xterm"},"stdin":"q\n","expected_text":"MemTotal"}
EOF
cat > .coldpass/claims.json <<'EOF'
[{"kind":"claim","claim":"Displays current and past /proc/meminfo data in a continuously updated display.","source":"`memfo` provides a low-overhead, stable, and highly customizable view of your system's `/proc/meminfo` data, designed for both short-term and long-term monitoring and performance debugging.","input":"Start memfo and quit with q.","expected":"Memory statistics including MemTotal are rendered.","probe_kind":"cli","argv":["<guest-path>"],"cwd":"<guest-path>","env":{"TERM":"xterm"},"stdin":"q\n","expected_text":"MemTotal"}]
EOF
cat > .coldpass/examples.json <<'EOF'
[{"kind":"example","claim":"Run the documented interactive memfo viewer and quit.","source":"README.md / Quick Start","input":"q key","expected":"Current memory rows are displayed before exit.","argv":["<guest-path>"],"cwd":"<guest-path>","env":{"TERM":"xterm"},"stdin":"q\n","expected_text":"MemTotal"}]
EOF
cat > .coldpass/cycles.json <<'EOF'
{"detected":false,"checks":[],"reason":"Inspected README command-line options, interaction keys, and memfo/memfod entrypoints. The README describes continuous sampling and optional daemon startup, but provides no one-shot cycle trigger; the documented operation is an interactive viewer."}
EOF
<env-var>=<guest-path> python3 -I <guest-path> --validate --replay
cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["<guest-path>","--help"],"cwd":"<guest-path>","expected_text":"usage: memfo"}
EOF
cat > .coldpass/claims.json <<'EOF'
[{"kind":"claim","claim":"memfo accepts the documented command line options.","source":"usage: memfo [-h] [-u {KiB,MB,MiB,GB,GiB,human}] [-i {Var,5s,15s,30s,1m,5m,15m,1hr}] [-d] [-c CONFIG]","input":"memfo --help","expected":"Usage and options are printed.","probe_kind":"cli","argv":["<guest-path>","--help"],"cwd":"<guest-path>","expected_text":"usage: memfo"}]
EOF
cat > .coldpass/examples.json <<'EOF'
[{"kind":"example","claim":"Inspect available memfo command line options.","source":"README.md / Command Line Options","input":"--help","expected":"Usage options appear.","argv":["<guest-path>","--help"],"cwd":"<guest-path>","expected_text":"usage: memfo"}]
EOF
<env-var>=<guest-path> python3 -I <guest-path> --validate --replay
cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["/usr/bin/script","-q","-c","<guest-path>","/dev/null"],"cwd":"<guest-path>","env":{"TERM":"xterm"},"stdin":"q\n","expected_text":"MemTotal"}
EOF
cat > .coldpass/claims.json <<'EOF'
[{"kind":"claim","claim":"Displays system /proc/meminfo values.","source":"`memfo` is a viewer for `/proc/meminfo` that shows its data:","input":"Run interactively and quit.","expected":"MemTotal is visible.","probe_kind":"cli","argv":["/usr/bin/script","-q","-c","<guest-path>","/dev/null"],"cwd":"<guest-path>","env":{"TERM":"xterm"},"stdin":"q\n","expected_text":"MemTotal"}]
EOF
cat > .coldpass/examples.json <<'EOF'
[{"kind":"example","claim":"Start the interactive memory viewer and quit.","source":"README.md / Quick Start","input":"q","expected":"Memory rows include MemTotal.","argv":["/usr/bin/script","-q","-c","<guest-path>","/dev/null"],"cwd":"<guest-path>","env":{"TERM":"xterm"},"stdin":"q\n","expected_text":"MemTotal"}]
EOF
<env-var>=<guest-path> python3 -I <guest-path> --validate --replay
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","fault_owner":null,"operation":"Interactive /proc/meminfo monitor","operation_scope":"Installed memfo 2.0.8 with Python 3.12.3; verified terminal rendering of MemTotal and related live memory rows using a PTY, then quit with q.","steps":["Checked Python 3.12.3 against README Python 3.11+ requirement.","Installed pipx and python3-venv with sudo apt-get after system pip refused user install under externally-managed-environment.","Ran pipx install memfo.","Ran memfo in a pseudo-terminal and confirmed MemTotal rendering and normal quit.","Validated and replayed probe, README claim, example and cycle evidence."],"deviations":["The first direct pipx install attempt failed with externally-managed-environment; installing the OS pipx package resolved setup.","Checker replay requires /usr/bin/script to provide a PTY to curses; the raw command fails cbreak() returned ERR in noninteractive replay.","Manually tried documented ? help key; it crashes with AttributeError: 'ConsoleWindow' object has no attribute 'put_body'. The basic viewer operation succeeds."],"stuck_step":null,"main_blocker":null,"plain_failure":null,"suggested_fix":null}
EOF
<env-var>=<guest-path> python3 -I <guest-path> --validate --replay