Readme

• Agent instructions
• Index
• Setup
  • Dependencies
  • Install dotfiles
  • Android / Termux
  • GPT TODO sync
  • nix
    • Setup nix

Agent instructions

Before editing this repository, read AGENTS.md and follow it as the repository editing contract.

In particular, keep literate Org sources and their tangled/generated outputs synchronized, and update the relevant documentation in the same change whenever behavior, architecture, ownership, deployment, interfaces, workflows, host/profile names, or important invariants change.

Index

• Dotfiles wiki
• OpenCode, Codex, and ChatGPT Desktop modules
• Global Prolog verification policy and hooks
• Agent instructions
• Bash
• Desktop Emacs config
• Emacs profile switcher
• Termux bootstrap
• Termux and Android companion apps
• Termux remote desktop workflows
• Native Android Org/Vim config
• Termux Doom config
• Android Emacs profiles
• Qtile literate config
• Qtile runtime notes
• Dunst Config
• Todo List

My desktop

Setup

Dependencies

If you want everything to work out of the box, i highly recommend nixos. My shell is bash. Otherwise

• nix
• git
• direnv
• starship
• curl

Install dotfiles

Clone the repo to ~/.dotfiles and run GNU Stow from the checkout.

Android / Termux

Android has a Doom-free, Org-first native Emacs profile and a separate full Doom profile for Termux development. The native profile uses Evil/Vim bindings, org-modern, native touch behavior, and an Org-centric bottom toolbar. The Doom profiles keep the existing desktop/Termux feature set intact.

For a fresh Termux install:

curl -fsSL https://raw.githubusercontent.com/lost-rob0t/dotfiles/master/bootstrap-termux.sh | bash

The bootstrap performs a full Termux upgrade and installs Git, GNU Stow, Emacs, SWI-Prolog, SBCL on supported 64-bit Android architectures, Nim, Python, the full Termux Doom profile, OpenCode through a PRoot guest, and Termux:Widget shortcuts.

Useful entry points after installation:

platform-enter --info
emacs-org                 # Doom-free Org/Vim profile
emacs-termux              # full Termux Doom
android-emacs-stow        # install the native ~/.emacs.d wrapper
doom-termux sync
git --version
ai

Chemacs/profile users can select explicitly:

emacs --with-profile android
emacs --with-profile org
emacs --with-profile doomemacs
emacs --with-profile termux-doom
emacs --with-profile temple

The paired Android build workflow builds GNU Emacs for the com.termux shared user and packages current Termux, API, Widget, Boot, Float, Styling, and Tasker APKs re-signed with the same compatibility key. That lets native Emacs execute the Termux Git installation via PATH without setting LD_LIBRARY_PATH. See android/README.org for the signature/install caveat and release bundle layout.

The remote desktop helpers and extra Termux widgets are maintained in scripts/termux-remote.org. They add fast SSH recovery for the flake desktop, remote ChatGPT startup under tmux, Org capture, an Agent Zero local-forward widget, and a visible dotfiles sync shortcut.

Install or refresh them after pulling the repository:

pkg install tmux
git -C ~/.dotfiles pull --ff-only
bash ~/.dotfiles/scripts/install-termux-widgets

The two remote commands are also usable directly after installation:

remote-gui-launch flake chatgpt.desktop chatgpt
agent-zero-tunnel flake 50080

The Agent Zero tunnel forwards the remote loopback service to http://127.0.0.1:50080 on the phone. Both remote workflows use five-second SSH keepalives by default and remain configurable through the environment variables documented in the literate source.

The canonical Android sources are android/config.org, emacs/profiles.org, bootstrap-termux.org, and android/doom/config.org.

GPT TODO sync

The durable private Org checkout defaults to ~/Documents/gpt-todos. Existing agenda/*.org files remain mirrored into ~/Documents/Notes/org/agenda for Todo Manager compatibility, while the rest of ~/Documents/Notes/org/ is mirrored under the repository's notes/ tree. This makes the same private Git repository the durable Org-roam/dailies/inventory/shared-agent-memory store.

After the dotfiles checkout exists, this one-liner updates dotfiles, performs an initial sync, and installs the five-minute cron entry:

git -C ~/.dotfiles pull --ff-only && bash ~/.dotfiles/scripts/gpt-todos-sync --deploy 5

The dotfiles-owned deployment command by itself is:

bash ~/.dotfiles/scripts/gpt-todos-sync --deploy 5

nix

Setup nix

Install nix: https://nixos.org/download

nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
nix-channel --update
nix-shell '<home-manager>' -A install
home-manager switch --flake github:lost-rob0t/dotfiles#unseen@flake

you might need to update the username to match yours.

To update the home-manager install just run

home-manager switch --flake github:lost-rob0t/dotfiles#unseen@flake

Since you will be using this with your username, you will need to edit the username.