gerardo/framebridge
1
0 Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Align website and shared guide with three signed Linux channels

Browse Source
This commit is contained in:
Gerardo Betancourt committed 2026-10-28 12:07:03 -04:00
1 parent e98d0d70e6
commit c0a679d989
16 files changed
+397 -151
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

source/docs/COMMAND-GUIDE.json
+25 -25
View File
@@ -1,19 +1,19 @@
{
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topics": {
"start": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "start",
"title": "Start with FrameBridge",
"sections": [
{
"heading": "One interface for people and agents",
"body": "FrameBridge provides tools and a shared command-line interface for human operators and authorized agents. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.",
"body": "FrameBridge provides network administration tools and a shared command-line interface for a home Linux network with one human administrator and authorized agents. Desktop access is an auxiliary tool. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.",
"commands": [
"fb help",
"fb status",
@@ -22,9 +22,9 @@
},
{
"heading": "Install and connect",
"body": "Install the .deb built for your exact Debian 13, Ubuntu 24.04/26.04, Linux Mint 22.x or LMDE 7 amd64 profile. These compatibility candidates still require installation and lifecycle validation on each target. Select the artifact from the matching profile folder and keep the distribution system Python. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.",
"body": "Install the package built for your exact Debian 13, Ubuntu 24.04 or Linux Mint 22.x amd64 profile. These are the three release profiles; other distributions and architectures are outside this release. Keep the distribution system Python: 3.13 on Debian 13, 3.12 on Ubuntu 24.04 and Mint 22.x. Use the matching signed APT suite: trixie, noble or mint22. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.",
"commands": [
"sudo apt install ./framebridge-expanded_0.3.2+private.20261028.2_amd64.deb",
"sudo apt install ./framebridge-expanded_0.3.3_amd64.deb",
"fb connect"
]
},
@@ -64,12 +64,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "606e18e34e2b71a8a17ea3e05823a03b49b7a73d3b7a68dfaa725df9a754f16b"
"guide_sha256": "23abd7eec3efb77ca160c97fec9b8bacc7040419946e75584ed563a509577a57"
},
"commands": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "commands",
"title": "Command reference",
@@ -136,12 +136,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "b765ac3fd5e90518f60f93969c86b4d5f04946cb8604b61a1e462833a7957172"
"guide_sha256": "432ab37e7249793cbe72e42d27582d70c2d2c1394ac1f5418b5d3e211e6a7c06"
},
"connection": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "connection",
"title": "Connect and disconnect ChatGPT",
@@ -190,12 +190,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "eb8ec2e6d26617b76ccd3d6972233b7fab74072275275c8981d09166bef0d12c"
"guide_sha256": "c41d5c436a7039cfacd9cde4933e24c9f7d6235d43e2e9f4fe106f1a4c631764"
},
"lifecycle": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "lifecycle",
"title": "Services, connection intent and boot policy",
@@ -256,12 +256,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "eb36c2d78bcda926b896a94385892ce3d479e56dce8a808ad55adfa601472f33"
"guide_sha256": "084358c9d1d41e0639b49d01c7e40b613127e3ead77e156cc2624850c7ebdb16"
},
"nodes": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "nodes",
"title": "Central and node operation",
@@ -310,12 +310,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "fc9d260c0f0b4e4f84087297396044058d7ec2b8821391dae5187eb58683cad7"
"guide_sha256": "ec2adb6ba2cb36e3747bcb4975a6b777ad88d4fe2b9b1cfb1a2f6ec1e8dab43a"
},
"terminals": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "terminals",
"title": "Persistent Bash terminals",
@@ -376,12 +376,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "162f069fbdb4584639be386163239530c1b9b883972ab212f5bccd47f6639e82"
"guide_sha256": "0aba231493d9ecae071ecdf5197440e0714393364948079fc4d163ff70cc67e3"
},
"screens": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "screens",
"title": "Authentic screen observation and input",
@@ -431,12 +431,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "1734ee9890fe63d60fe008879c75804fa0c755c0396153a4be2e8228fd790316"
"guide_sha256": "eeaf9cfed9e7a84d59a727c4388b0869b02a6ed870647e87b333d318a3584c9a"
},
"diagnostics": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "diagnostics",
"title": "Status and diagnosis",
@@ -481,12 +481,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "2899db14de0686a2dc50a2b22edf35d97d7d53e162300194fe57c126dde395dc"
"guide_sha256": "77a65897aacfeaa2b06dd184ac78d366d28980847b0cbdd1429c889e0e2898a6"
},
"security": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "security",
"title": "Authorization, distribution and safe operation",
@@ -521,12 +521,12 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "addecd0420c18951683f32bdc05a9ab7d00a1b2150ecd6087bd99b784196696f"
"guide_sha256": "f257fcbbdec39395a15655b0a5123fb385ce7eaba2a256de07a5da65eab3ec8e"
},
"compatibility": {
"ok": true,
"product": "FrameBridge",
"version": "0.3.2+private.20261028.2",
"version": "0.3.3",
"guide_schema": 1,
"topic": "compatibility",
"title": "Compatibility with earlier commands",
@@ -569,8 +569,8 @@
],
"read_only": true,
"capabilities_verified": false,
"guide_sha256": "0dcbf347bfba8b0cff176d5c96bcf1a95f2c83fc6398559d54ac3b4c83d74b0a"
"guide_sha256": "9056f77b27f326bebfdbb54dd10b748d6315797b07afe1aee29f42d6210dae36"
}
},
"guide_sha256": "1f259d089526e7e38f1732afbc4ceae2af62ec36c8630452fd8f4ef4ccb90069"
"guide_sha256": "5dc6ed2744e53d7d2ce1f471e2ab94d50f9c52f83ae85abe495bacad34b1b96c"
}
source/docs/COMMAND-REFERENCE.md
+4 -4
View File
@@ -1,6 +1,6 @@
# FrameBridge — command guide
Version: 0.3.2+private.20261028.2 | Guide schema: 1
Version: 0.3.3 | Guide schema: 1
This reference is generated from the shared CLI/MCP guide. Use the matching installed version.
@@ -23,7 +23,7 @@ This reference is generated from the shared CLI/MCP guide. Use the matching inst
### One interface for people and agents
FrameBridge provides tools and a shared command-line interface for human operators and authorized agents. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.
FrameBridge provides network administration tools and a shared command-line interface for a home Linux network with one human administrator and authorized agents. Desktop access is an auxiliary tool. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.
~~~sh
fb help
@@ -33,10 +33,10 @@ fb --json status
### Install and connect
Install the .deb built for your exact Debian 13, Ubuntu 24.04/26.04, Linux Mint 22.x or LMDE 7 amd64 profile. These compatibility candidates still require installation and lifecycle validation on each target. Select the artifact from the matching profile folder and keep the distribution system Python. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.
Install the package built for your exact Debian 13, Ubuntu 24.04 or Linux Mint 22.x amd64 profile. These are the three release profiles; other distributions and architectures are outside this release. Keep the distribution system Python: 3.13 on Debian 13, 3.12 on Ubuntu 24.04 and Mint 22.x. Use the matching signed APT suite: trixie, noble or mint22. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.
~~~sh
sudo apt install ./framebridge-expanded_0.3.2+private.20261028.2_amd64.deb
sudo apt install ./framebridge-expanded_0.3.3_amd64.deb
fb connect
~~~
source/docs/DEBIAN-TUTORIAL.md
+4 -4
View File
@@ -1,6 +1,6 @@
# FrameBridge — Debian, Ubuntu and Linux Mint installation and first use
Version: 0.3.2+private.20261028.2 | Guide schema: 1
Version: 0.3.3 | Guide schema: 1
This reference is generated from the shared CLI/MCP guide. Use the matching installed version.
@@ -23,7 +23,7 @@ This reference is generated from the shared CLI/MCP guide. Use the matching inst
### One interface for people and agents
FrameBridge provides tools and a shared command-line interface for human operators and authorized agents. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.
FrameBridge provides network administration tools and a shared command-line interface for a home Linux network with one human administrator and authorized agents. Desktop access is an auxiliary tool. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.
~~~sh
fb help
@@ -33,10 +33,10 @@ fb --json status
### Install and connect
Install the .deb built for your exact Debian 13, Ubuntu 24.04/26.04, Linux Mint 22.x or LMDE 7 amd64 profile. These compatibility candidates still require installation and lifecycle validation on each target. Select the artifact from the matching profile folder and keep the distribution system Python. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.
Install the package built for your exact Debian 13, Ubuntu 24.04 or Linux Mint 22.x amd64 profile. These are the three release profiles; other distributions and architectures are outside this release. Keep the distribution system Python: 3.13 on Debian 13, 3.12 on Ubuntu 24.04 and Mint 22.x. Use the matching signed APT suite: trixie, noble or mint22. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.
~~~sh
sudo apt install ./framebridge-expanded_0.3.2+private.20261028.2_amd64.deb
sudo apt install ./framebridge-expanded_0.3.3_amd64.deb
fb connect
~~~
source/docs/framebridge.1
+4 -4
View File
@@ -1,4 +1,4 @@
.TH FRAMEBRIDGE 1 "2026-10-27" "FrameBridge 0.3.2+private.20261028.2" "User Commands"
.TH FRAMEBRIDGE 1 "2026-10-28" "FrameBridge 0.3.3" "User Commands"
.SH NAME
framebridge, fb \- use local Linux tools and enrolled nodes with ChatGPT
.SH SYNOPSIS
@@ -10,7 +10,7 @@ The names fb and framebridge execute the same program.
The tools run on the selected Linux computers; the ChatGPT model remains hosted.
.SH START WITH FRAMEBRIDGE
.SS One interface for people and agents
FrameBridge provides tools and a shared command\-line interface for human operators and authorized agents. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.
FrameBridge provides network administration tools and a shared command\-line interface for a home Linux network with one human administrator and authorized agents. Desktop access is an auxiliary tool. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.
.PP
.nf
fb help
@@ -18,10 +18,10 @@ fb status
fb \-\-json status
.fi
.SS Install and connect
Install the .deb built for your exact Debian 13, Ubuntu 24.04/26.04, Linux Mint 22.x or LMDE 7 amd64 profile. These compatibility candidates still require installation and lifecycle validation on each target. Select the artifact from the matching profile folder and keep the distribution system Python. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.
Install the package built for your exact Debian 13, Ubuntu 24.04 or Linux Mint 22.x amd64 profile. These are the three release profiles; other distributions and architectures are outside this release. Keep the distribution system Python: 3.13 on Debian 13, 3.12 on Ubuntu 24.04 and Mint 22.x. Use the matching signed APT suite: trixie, noble or mint22. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.
.PP
.nf
sudo apt install ./framebridge\-expanded_0.3.2+private.20261028.2_amd64.deb
sudo apt install ./framebridge\-expanded_0.3.3_amd64.deb
fb connect
.fi
.SS Updating and removal
source/expanded/framebridge_expanded/guide_data.py
+2 -11
View File
@@ -4,19 +4,10 @@ from . import __version__
GUIDE = {'start': {'title': 'Start with FrameBridge',
'sections': [{'heading': 'One interface for people and agents',
'body': 'FrameBridge provides tools and a shared command-line interface '
'for human operators and authorized agents. fb is the short name '
'for framebridge; both run the same program. The tools run on '
'your Linux computers. The ChatGPT model remains hosted. Read '
'this guide for the installed version before operating; confirm '
'the receiver, target and available capabilities. Use the '
'installed CLI and tools for normal work. Edit software only when '
'the owner explicitly requests development, using a separate '
'source clone and reviewable changes rather than rewriting the '
'installed program.',
'body': 'FrameBridge provides network administration tools and a shared command-line interface for a home Linux network with one human administrator and authorized agents. Desktop access is an auxiliary tool. fb is the short name for framebridge; both run the same program. The tools run on your Linux computers. The ChatGPT model remains hosted. Read this guide for the installed version before operating; confirm the receiver, target and available capabilities. Use the installed CLI and tools for normal work. Edit software only when the owner explicitly requests development, using a separate source clone and reviewable changes rather than rewriting the installed program.',
'commands': ['fb help', 'fb status', 'fb --json status']},
{'heading': 'Install and connect',
'body': 'Install the .deb built for your exact Debian 13, Ubuntu 24.04/26.04, Linux Mint 22.x or LMDE 7 amd64 profile. These compatibility candidates still require installation and lifecycle validation on each target. Select the artifact from the matching profile folder and keep the distribution system Python. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.',
'body': 'Install the package built for your exact Debian 13, Ubuntu 24.04 or Linux Mint 22.x amd64 profile. These are the three release profiles; other distributions and architectures are outside this release. Keep the distribution system Python: 3.13 on Debian 13, 3.12 on Ubuntu 24.04 and Mint 22.x. Use the matching signed APT suite: trixie, noble or mint22. Normal first connection does not require a separate setup, doctor or start sequence. Run connect in a normal interactive terminal; advanced setup is optional for central/node roles and public settings.',
'commands': ["sudo apt install ./framebridge-expanded_" + __version__ + "_amd64.deb", 'fb connect']},
{'heading': 'Updating and removal',
'body': 'Install an official update through the normal package manager when that update has been published. Normal removal stops package-owned managed processes and can retain the user profile and encrypted connection material; it is not a credential-forgetting operation. On systemd 255, package removal also revokes the administrative boot-credential grant. After reinstalling, run fb connect interactively to provision that grant again; retained files alone do not restore startup. Use the explicit credentials forget action first when that is your intended outcome. Do not assume purge erases user-profile data. An explicit downgrade also revokes administrative helper grants before the older package files replace the helper. Helper-backed profiles require a new interactive connect with a compatible package before managed startup can be restored.',
source/packaging/generate_command_docs.py
+1 -1
View File
@@ -26,7 +26,7 @@ def markdown(data, title):
def roff(text):
return text.replace('\\','\\e').replace('-','\\-')
def man(data):
lines=['.TH FRAMEBRIDGE 1 "2026-10-27" "FrameBridge '+__version__+'" "User Commands"',
lines=['.TH FRAMEBRIDGE 1 "2026-10-28" "FrameBridge '+__version__+'" "User Commands"',
'.SH NAME','framebridge, fb \\- use local Linux tools and enrolled nodes with ChatGPT',
'.SH SYNOPSIS','.B framebridge',
'[\\-\\-json] [\\-\\-state\\-dir DIRECTORY] COMMAND [ARGUMENTS]',