welcome to the ghostwheel

1. INPROGRESS Main Index
2. TODO Feature Index
3. Development Notes
4. TODO Instance Index
5. TODO Public Catalog
6. TODO Capabilities Index
7. TODO References and Documentation
- 7.1. TODO References
  - 7.1.1. Important Externally Maintained Software
- 7.2. TODO Top Level Documentation Index
8. About the ghostwheel
- 8.1. About C4
- 8.2. About the index.org of the ghostwheel
9. TODO Copyright and Licensing

Please restate the problem in terms of the solution. -variously attributed

You are reading the anonymous index at the ghostwheel.

Here, find listed our publicly documented capabilities, along with their status, documentation, licensing terms and source code for programs, and so forth.

1. INPROGRESS Main Index

Universe	State	Description
index.org	⬆️	<- You are here
README.org	⬆️	This is the `ghostwheel` c4 document
c4.org	⬆️	The c4 homepage
corwin.org	⬆️	Corwin things living on the `ghostwheel`
orgvm-demo.org	⬆️	OrgVM live-demo instance is hosted on the `ghostwheel`

2. TODO Feature Index

What are the main features of the project? What do we notice most immediately when broken? Replace this list with one for your solution (project, program, etc.).

Feature	Health	Description
[ ] participle dangler	⬆️	None shall path.
[ ] verb menacing engine	↪️	Don't, even.
[ ] noun unbundler	⏰	When.

3. Development Notes

Top-of-stack development tasks

[ ] enable inline editor POC on scratch.ghostwheel.cloud
[ ] build dynamic logo generator
[ ] add style-sheet selector web-control
[ ] build POC for status gauges
[ ] implement ping report (dsh.sh ping -v4 -c 1)
[ ] write OrgVM proxy for nginx
[ ] make OrvVM use dockerized emacsserver
[ ] update something to deb-13

4. TODO Instance Index

Here, list installed VMs and active services.

5. TODO Public Catalog

This section lists the programs (projects, etc) installed or available to install on the ghostwheel.

6. TODO Capabilities Index

Some current machine, project, etc. statuses would look lovely if injected..

..here.

7. TODO References and Documentation

Some top level documentation in this section would really tie this website together.

7.1. TODO References

7.1.1. Important Externally Maintained Software

Debian

While the ghostwheel includes hosts running several GNU/Linux distributions, we tend to reach first for Debian.
GNU Emacs

We can invoke Emacs in batch via c4 and OrgVM to execute code (babel) and for document and program generation (export and tangle) features.
org-html-themes

The org-html-themes project provides the baseline web UX used by default for many sites hosted on the ghostwheel. We can inject a header to include to HTML UX provided by this project when a document does not contain a SETUPFILE header.

7.2. TODO Top Level Documentation Index

It would be nice to generate a table of documentation links and put that here.

8. About the `ghostwheel`

The ghostwheel is an adhoc network of people and (often, also networked) our computers and other equipment. Our members, like the capabilities of the ghostwheel as a sum of components, vary over time per availability metrics, but tend toward slow-but-steady and like-it-or-not growth. Which we generally lean into.

8.1. About C4

The ghostwheel uses c4, which is a Continuous Creation, Command, and Control framework built atop OrgVM and other systems which build upon Emacs' org-mode to execute ("orchistrate") programs and, especially, to generate documents. Emacs' org-mode builds upon Markdown technologies which enable rich text that support including a variety of kinds of material (program sources, tables of data, documentation, images, …). OrgVM builds upon this by creating a virtualized (potentially stateful) Emacs environment around a given org-mode document. C4 provides convention based organizing principles to that, as well providing various "glue" tooling, generally in the form of a (web interactive) README.org file.

8.2. About the index.org of the `ghostwheel`

This is not the c4 README.org for the ghostwheel. This is only a (limited) cross-reference.

You are viewing the PUBLIC index for the ghostwheel; some links may be missing, broken, or prompt unexpectedly for registration or otherwise ask you to authentication or inform you of authorization issues. You are welcome to press the buttons, especially the ones which report trouble in the ghostwheel to us humble few that create such banal UX as these.

9. TODO Copyright and Licensing

The ghostwheel is a Free Software project.

This section defines a general statement of copyright and license for the ~ghostwheel~ especially for use in case where none other assertion of copyright and/or declaration of applicable license may be accepted: in such cases the GNU Public License shall apply (as described below).

Wherever possible please see individual files, blocks, etc. for more detailed attributions and licensing information.

Programs (projects, etc.) included or referenced in or by this document (or the ghostwheel) and having some other stated terms should not be considered with respect to this declaration: such are (remain) the property of their respective owners, rights holders, etc..

Copyright 2025 Corwin Brust <corwin@bru.st>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.