Skip to content

docs: update README security claims and CLI options - #34

Merged
danbugs merged 2 commits into
mainfrom
fix/readme-docs
May 15, 2026
Merged

docs: update README security claims and CLI options#34
danbugs merged 2 commits into
mainfrom
fix/readme-docs

Conversation

@danbugs

@danbugs danbugs commented May 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Replaced "No host function calls" Key Feature (factually incorrect since
    __dispatch exists) with "Thin, opt-in host surface" — clarifies that the
    guest has no host access by default, and features are explicitly enabled via
    --mount, --net, etc. Links to HOST_FUNCTIONS.md for the full list.
  • Replaced the 5-flag CLI options block with the complete set of 14 flags from
    the actual Args struct in main.rs.

Test plan

  • Verified all documented flags match host/src/main.rs Args struct

danbugs added 2 commits May 15, 2026 05:26
…EADME

Signed-off-by: danbugs <danilochiarlone@gmail.com>
Signed-off-by: danbugs <danilochiarlone@gmail.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the README to (1) replace an inaccurate "No host function calls" feature claim with a more honest description of the opt-in host surface and __dispatch bridge, and (2) bring the documented CLI options block in line with the actual Args struct in host/src/main.rs.

Changes:

  • Reword the security/feature bullet to clarify that the guest has no host access by default but opts in via flags like --mount, --net, --enable-tools, with a pointer to HOST_FUNCTIONS.md.
  • Expand the CLI options block from 5 to 14 flags, matching the current Args struct (including --enable-tools, --mount, --net, --net-allow, --net-block, --port, --repeat, -e/--exec).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Linux Benchmarks

Details
Benchmark suite Current: a96e453 Previous: 79b32ae Ratio
hello_world (median) 20 ms 20 ms 1
pandas (median) 100 ms 100 ms 1
density (per VM) 7 MB 7 MB 1
snapshot (disk) 385 MiB 385 MiB 1

This comment was automatically generated by workflow using github-action-benchmark.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Windows Benchmarks

Details
Benchmark suite Current: a96e453 Previous: 79b32ae Ratio
hello_world (median) 242 ms 234 ms 1.03
pandas (median) 785 ms 708 ms 1.11
density (per VM) 6 MB 6 MB 1
snapshot (disk) 393 MiB 393 MiB 1

This comment was automatically generated by workflow using github-action-benchmark.

@danbugs
danbugs merged commit 8d95468 into main May 15, 2026
81 checks passed
@danbugs
danbugs deleted the fix/readme-docs branch May 15, 2026 06:06
@danbugs danbugs mentioned this pull request May 15, 2026
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants