Seeed-Jetson-DevelopTool / jetson-pc-wired-share
AGENTS.md57 starsChanged 4 months agoMITView on GitHub
Temporarily share a Linux PC's internet connection to a Jetson over Ethernet using NetworkManager while preserving an existing static-IP SSH link. Use when the user asks to let a directly connected Jetson access the internet through the PC, or to start, verify, or stop that temporary sharing.
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,774 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository297 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ai-nvrAGENTS.md
- allxon-ota-updateAGENTS.md
- allxon-setupAGENTS.md
- alwaysai-setupAGENTS.md
- backup-restoreAGENTS.md
- bsp-source-buildAGENTS.md
- clawdbot-developmentAGENTS.md
- cochl-sense-setupAGENTS.md
- cvedia-setupAGENTS.md
- dashcamnet-xavier-nx-multicameraAGENTS.md
- deciai-setupAGENTS.md
- deepseek-quick-deployAGENTS.md
- deploy-deepseek-mlcAGENTS.md
- deploy-depth-anything-v3AGENTS.md
- deploy-diaAGENTS.md
- deploy-efficient-vision-engineAGENTS.md
- deploy-frigateAGENTS.md
- deploy-live-vlm-webuiAGENTS.md
- deploy-nvbloxAGENTS.md
- deploy-ollama-anythingllmAGENTS.md
- deploy-riva-llama2AGENTS.md
- developtool-deviceAGENTS.md
- disk-encryptionAGENTS.md
- diy-bsp-buildAGENTS.md
- ethercat-communicationAGENTS.md
- ethercat-setupAGENTS.md
- finetune-llm-llama-factoryAGENTS.md
- fix-browser-snap-jetsonAGENTS.md
- gapi-setupAGENTS.md
- generative-ai-introAGENTS.md
- gpt-oss-liveAGENTS.md
- gr00t-n1-5-deploy-thorAGENTS.md
- gr00t-n1-6-deploy-agxAGENTS.md
- hardhat-setupAGENTS.md
- hybrid-bsp-dk-to-recomputerAGENTS.md
- imx477-a603-setupAGENTS.md
- j501-viola-fruit-sortingAGENTS.md
- jetpack5-ssd-boot-fixAGENTS.md
- jetpack-flash-wsl2AGENTS.md
- jetpack-jetson-overviewAGENTS.md
- jetpack-ota-updateAGENTS.md
- jetson-ai-toolsAGENTS.md
- jetson-docker-setupAGENTS.md
- jetson-faqAGENTS.md
- jetson-project-galleryAGENTS.md
- jetson-resource-indexAGENTS.md
- jetson-tutorial-exercisesAGENTS.md
- ko-module-buildAGENTS.md
- l4t-differencesAGENTS.md
- langchain-output-formattingAGENTS.md
- lerobot-env-setupAGENTS.md
- llama-cpp-rpc-distributedAGENTS.md
- llm-interface-controlAGENTS.md
- local-chatbot-multimodalAGENTS.md
- local-chatbot-physicalAGENTS.md
- local-llm-text-to-imageAGENTS.md
- local-rag-llamaindexAGENTS.md
- lumeo-setupAGENTS.md
- maskcam-nanoAGENTS.md
- The first 60 shown.
The file
We split this AGENTS.md into the rules it gives an agent
8 rules. About 1 is common, 3 are distinctive, and 4 are very specific to this project.
≈1
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Common: line 8
Use a separate, non-autoconnecting NetworkManager profile on the PC.
- Distinctive: line 23
If the Jetson already has a static address and SSH uses the wired subnet, preserve the PC's existing address and subnet.
- Very specific: line 29
Create or update a profile named jetson-wired-share on the downstream interface.
- Very specific: line 42
If that profile already exists, use nmcli connection modify instead of creating a duplicate.
- Very specific: line 54
If split DNS (commonly Tailscale) still captures public lookups, also use resolvectl domain <interface> '~.' so the wired link routes …
- Distinctive: line 58
Verify from the Jetson, in order:
- Very specific: line 74
Remove only the runtime Jetson route added by this workflow, deactivate jetson-wired-share, and reactivate the original wired profile …
- Distinctive: line 86
Delete it only when the user asks.
≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Jetson PC wired internet sharing
Use a separate, non-autoconnecting NetworkManager profile on the PC. Keep the original wired profile intact so the operation is easy to reverse. Never put a sudo or SSH password in this skill, a connection profile, a script, or a log.
Start sharing
Inspect before changing anything:
nmcli device status, active connections,ip -br addr, andip route.ip route get <jetson-ip>to identify the PC interface carrying SSH.- The Jetson's interface, address, routes, and DNS over the existing SSH link.
- Confirm the PC has a working upstream/default route on a different interface.
Determine the downstream PC address:
- If the Jetson already has a static address and SSH uses the wired subnet, preserve the PC's existing address and subnet. This avoids losing SSH.
- Otherwise choose an unused RFC1918
/24that does not overlap any PC or Jetson route; NetworkManager's usual10.42.0.1/24is acceptable only after checking for conflicts.
Create or update a profile named
jetson-wired-shareon the downstream interface. Setconnection.autoconnect no,ipv4.method shared, the chosenipv4.addresses,ipv4.never-default yes, andipv6.method disabled. Then activate it. Do not edit or delete the original wired profile. Example shape:sudo nmcli connection add type ethernet \ ifname <pc-wired-interface> con-name jetson-wired-share autoconnect no \ ipv4.method shared ipv4.addresses <pc-address/cidr> \ ipv4.never-default yes ipv6.method disabled sudo nmcli connection up jetson-wired-shareIf that profile already exists, use
nmcli connection modifyinstead of creating a duplicate. Warn that activation may briefly flap the wired link.Configure the Jetson without making its static profile persistent unless the user explicitly asks. For an already-static Jetson, add a runtime route:
sudo ip route replace default via <pc-wired-ip> dev <jetson-interface> metric 100Retain any unrelated routes. If DNS is not already usable, set runtime DNS on that interface with
resolvectl dns <interface> <pc-wired-ip>when available. If split DNS (commonly Tailscale) still captures public lookups, also useresolvectl domain <interface> '~.'so the wired link routes ordinary DNS. For a DHCP-configured Jetson, renew DHCP instead.Verify from the Jetson, in order:
- ping the PC's downstream address;
- ping a public IP;
- resolve a public hostname;
- make a short HTTPS request.
Report the active profile, PC/Jetson addresses, route, and observed test results. Do not claim success based only on a NetworkManager status message.
NetworkManager ipv4.method shared owns DHCP/DNS forwarding and NAT. If it does
not work, inspect NetworkManager logs, IP forwarding, and nftables before making
additional changes. Do not disable the host firewall wholesale.
Stop sharing
Remove only the runtime Jetson route added by this workflow, deactivate
jetson-wired-share, and reactivate the original wired profile discovered at
the start:
sudo ip route del default via <pc-wired-ip> dev <jetson-interface> metric 100
sudo resolvectl revert <jetson-interface>
sudo nmcli connection down jetson-wired-share
sudo nmcli connection up <original-wired-profile>The share profile may remain saved for reuse because it has autoconnect disabled. Delete it only when the user asks. Recheck the original PC-to-Jetson SSH route after restoration.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

