Revise README with installation and usage updates

Updated installation instructions and usage details for the xonsh Flatpak package. Added information about the 'host' alias and symlinks for popular commands.

Author: anki-code

README.md

@@ -2,86 +2,48 @@
 
 Flatpak package for [xonsh](https://xon.sh/).
 
-## Build and Run
-
-```bash
-sudo apt-get install -y flatpak flatpak-builder
-pip install .
-xonsh build.xsh
-
+## Install and Run
+```xsh
+# Install flatpak e.g. `sudo apt-get install -y flatpak`
+# Download xonsh flatpak
+wget https://github.com/xonsh/xonsh-flatpak/releases/latest/download/xonsh.flatpak
 flatpak install --user xonsh.flatpak
 flatpak run io.github.xonsh.xonsh
 ```
 
-## Build Options
+## Usage
 
-```bash
-# Default: xonsh/xonsh @ main
-xonsh build.xsh
-
-# Custom repo and branch
-xonsh build.xsh --git-url https://github.com/anki-code/xonsh/tree/anki_new_start
-```
-
-The `--git-url` flag accepts GitHub, GitLab, Codeberg URLs with branch in the path,
-SSH URLs (`git@github.com:owner/repo.git`), or shorthand (`owner/repo`).
-
-## Host Command Forwarding
+### `host` alias
 
 The Freedesktop runtime includes ~728 standard Unix commands (`ls`, `cat`,
 `grep`, `curl`, etc.), but system-specific tools like `git`, `docker`, `ssh`
 are not available inside the Flatpak sandbox.
 
-### How it works
-
-```
-User types "git status"
-  → xonsh finds /app/libexec/host-cmds/git (symlink → host-spawn)
-    → host-spawn runs: flatpak-spawn --host --env=TERM=... git status
-      → flatpak-spawn executes "git status" on the host system
-        → output flows back to xonsh inside the sandbox
-```
-
-**`host-spawn`** is a single 2-line shell script:
+To solve this we have `host` alias in xonsh RC `flatpak.xsh`. It executes 
+the command on the host system e.g.
 
-```sh
-#!/bin/sh
-exec flatpak-spawn --host --env=TERM="${TERM:-xterm-256color}" "$(basename "$0")" "$@"
+```xsh
+host git status  # `flatpak-spawn --host git status`
 ```
 
-It uses `basename "$0"` to determine which command to run — so the same script
-works for every command via symlinks. `$TERM` is forwarded so that ncurses
-applications (`htop`, `vim`, `nano`, etc.) work correctly on the host.
-
-During the Flatpak build, symlinks are created for common host commands:
+### Symlinks to popular tools
 
-```
-/app/libexec/host-cmds/git    → /app/libexec/host-spawn
-/app/libexec/host-cmds/* → /app/libexec/host-spawn
-```
+In `io.github.xonsh.xonsh.yml` we have a list of popular commands
+(`git`, `docker`, `ssh`, `vim`, `htop`, etc). During the Flatpak build, 
+symlinks are created for popular host commands e.g. 
+`/app/libexec/host-cmds/git` will be the symlink to `/app/libexec/host-spawn`.
 
-The directory `/app/libexec/host-cmds` is **appended** to `$PATH` (not
-prepended), so sandbox binaries in `/app/bin` and `/usr/bin` always take
-priority over host-forwarded ones.
+The directory `/app/libexec/host-cmds` is appended to `$PATH` with low priority.
 
-### Pre-configured commands
 
-`git`, `docker`, `ssh`, `vim`, `htop`, and many more (~45 total).
-To see the full list or add more, edit the `for cmd in ...` loop in
-`io.github.xonsh.xonsh.yml`.
-
-### Running other host commands
-
-For commands without a symlink, use `flatpak-spawn` directly:
+## Build
 
 ```bash
-flatpak-spawn --host mycommand --flag
-```
-
-Or copy `flatpak-xonshrc.py` to `~/.config/xonsh/rc.d/` for the `host` alias:
-
-```xonsh
-host mycommand --flag
+sudo apt-get install -y flatpak flatpak-builder
+pip install .
+xonsh build.xsh  # or with GitHub/GitLab/Codeberg URL: `--git-url https://github.com/xonsh/xonsh/tree/another_branch_name`
+flatpak install --user xonsh.flatpak
+flatpak run io.github.xonsh.xonsh
 ```
 
 ## Links