Arroyo Systems Management

• What are Arroyo Systems?
• Arroyo Systems are "designed" to develop in fits and bursts
• NEXT Assembling an Arroyo System
• Structure of the Arroyo (Or: Table of Contents)
• Greetz and Thanks

What are Arroyo Systems?

Arroyo systems are the underlying design systems for the CCE Emacs init.el generator and Concept Operating System. It's used for managing my laptops' and desktop's and servers' and mobiles' software around an NixOS, Emacs, KDE, and Evil Mode. Arroyo Systems are distributed and developed as a collection of org-mode documents which can be used to provision and upgrade the system and are published on the web to enrich the lives of weirdos like me.

Arroyo allows you to build context-specific databases from a sort of hypermedia application which integrate with org-roam. Rather than extending or working within the API-space of org-roam itself, Arroyo is an org-mode parser and metadata extractor, and a database cache model layer which can be queried to assemble a NixOS system and highly-customized Emacs installation-and-configuration.

it's designed such that a user can plug various pieces of system configuration together in the form of org-mode documents downloaded or synced from trustworthy friends, creating a system which is literally (literately) self-documented.

An Arroyo System's configuration can be published on the web using Arcology, an python web document publishing framework built using Arroyo's parser and philosophies with the end goal of managing socially-maintained, hand-crafted, and user-customized Linux systems.

Arroyo Systems are "designed" to develop in fits and bursts

Arroyos are a type of stream bed biome common in the American southwest and northern Mexico Sonora Bioregion which is dry for most of the year and gets most of its rain in brief torrential surface flows. When I was young, I lived in a home which backed up to an arroyo and I spent quite some time wandering its trails and its unkept willows and catching my clothes on catclaws, using it as a shortcut through the neighborhood and an escape in to an increasingly developed suburban sprawl.

I was always enchanted with the arroyo during and after the torrential downpours Phoenix would have in the late summers, as tonnes of water passed through willows and waterweed. The arroyo would teem with life during the monsoon season as the brief intense rains pushed life out of its shaded cracks and in to a frenzy of growth and development and used it as a migration route just as the humans in the built environment around it did in its dry periods.

The Arroyo system pulls inspiration from this as a lens to look at how personal systems management is spurred on by

• keeping up with ecosystem development and migration without undue effort
• external changes and new tools should be easy to try and easy to then disregard
• slow thinking and quick implementation of internal development to match with life needs
• management of overgrowth through periods of careful usage and evaluation
• an oasis path that cuts through the status quo

This system develops when I feel like it, and has slowly over the course of a decade developed in to something which can be shared and perhaps replicated. When a beautiful summer's day spurs me to investigate a new library or I learn about a new paradigm I sit and think about it. The Arroyo floods and growth follows quickly; there might not be another rain of insight until winter, after all.

NEXT Assembling an Arroyo System

Rebuild of The Complete Computer

• How do I use these libraries to generate an Emacs init file?
• How do I use these libraries to build a NixOS system?
• How do I use these libraries to build an emacs-native-comp with packages provided by NixOS at build time?
• How do I use these libraries to install and manage software for my user account?
• How do I build more generators on top of this system?

Arroyo is itself an Arroyo Emacs module

It should probably be defined as a Arroyo Home Manager module, too, once the code has stabilized..

(add-to-list 'load-path "~/org/arroyo")
(require 'org-roam)
; (require 'arroyo-db)
; (require 'arroyo-utils)
(require 'arroyo-home-manager)
(require 'arroyo-nixos)
(require 'arroyo-emacs)
; (require 'arroyo-feeds)

Structure of the Arroyo (Or: Table of Contents)

(These are spread across multiple projects right now, I am still nailing down the exact structure of the Arroyo, Arcology, and CCE)

• The arroyo_rs Native Org Parser

  • Arroyo Org Parser
  • Arroyo HTML exporter
• Arcology Roam Models
• The Arroyo Generators
• Arcology CLI Interface

Greetz and Thanks

the emacs and nixpkgs communities

org-roam

pulling inspiration from vulpea and vino

Torbjorn Loken

alphapapa

maya kate

Yoshiki Shmitz (RIP to a real one)

Malleable Systems Collective