From 5ad9722a848cb1ae7fd39f27d048803be2f5fcb2 Mon Sep 17 00:00:00 2001
From: Harivansh Rathi <rathiharivansh@gmail.com>
Date: Sat, 11 Apr 2026 21:59:00 +0000
Subject: [PATCH] feat: nicer guest image

---
 Dockerfile         |  4 +++-
 defaults/.zshrc    |  1 +
 defaults/AGENTS.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 defaults/AGENTS.md

diff --git a/Dockerfile b/Dockerfile
index 16d3643..1b53a30 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -136,12 +136,14 @@ COPY defaults/.zshrc /home/node/.zshrc
 COPY defaults/.bashrc /home/node/.bashrc
 COPY defaults/.profile /home/node/.profile
 COPY defaults/pip.conf /etc/pip.conf
+COPY defaults/AGENTS.md /home/node/AGENTS.md
 COPY terminfo/xterm-ghostty.terminfo /tmp/xterm-ghostty.terminfo
 COPY terminfo/xterm-kitty.terminfo /tmp/xterm-kitty.terminfo
 
 RUN chmod 755 /usr/local/bin/microagent-init /usr/local/bin/microagent-desktop-session /usr/local/bin/microagent-network-up \
   && chmod 755 /opt/desktop/scripts/apply-desktop-profile.sh \
-  && chown node:node /home/node/.zshrc /home/node/.bashrc /home/node/.profile \
+  && chown node:node /home/node/.zshrc /home/node/.bashrc /home/node/.profile /home/node/AGENTS.md \
+  && ln -sf /home/node/AGENTS.md /home/node/CLAUDE.md \
   && usermod -s /usr/bin/zsh node \
   && install -d /opt/zsh/pure \
   && ln -sf /usr/local/bin/microagent-init /sbin/init \
diff --git a/defaults/.zshrc b/defaults/.zshrc
index dc248b0..937514e 100644
--- a/defaults/.zshrc
+++ b/defaults/.zshrc
@@ -57,6 +57,7 @@ alias ls='eza --group-directories-first --icons=auto'
 alias la='eza -a --group-directories-first --icons=auto'
 alias ll='eza -lah --git --group-directories-first --icons=auto'
 alias lt='eza --tree --level=2 --group-directories-first --icons=auto'
+alias cc='claude --dangerously-skip-permissions'
 
 if [ -r /usr/share/zsh-autosuggestions/zsh-autosuggestions.zsh ]; then
   source /usr/share/zsh-autosuggestions/zsh-autosuggestions.zsh
diff --git a/defaults/AGENTS.md b/defaults/AGENTS.md
new file mode 100644
index 0000000..698db59
--- /dev/null
+++ b/defaults/AGENTS.md
@@ -0,0 +1,46 @@
+# MicroAgent Computer
+
+Cloud VM with full desktop environment (XFCE + Chrome + VNC).
+
+## Desktop
+
+- X server: Xvfb on :0 (1280x800x24)
+- Window manager: XFCE
+- VNC: port 5900 (x11vnc), noVNC: port 6080 (websockify)
+
+## Screenshots
+
+```bash
+# Full desktop screenshot
+scrot /tmp/screenshot.png
+
+# Chrome headless screenshot
+google-chrome --headless --no-sandbox --screenshot=/tmp/page.png https://example.com
+
+# Chrome headless DOM dump
+google-chrome --headless --no-sandbox --dump-dom https://example.com
+```
+
+## GUI interaction
+
+```bash
+xdotool type "hello"
+xdotool key Return
+xdotool mousemove 640 400 && xdotool click 1
+```
+
+## Installing packages
+
+```bash
+sudo apt-get install -y <package>
+pip install <package>
+npm install <package>
+```
+
+## User
+
+`node` with passwordless sudo. Home: `/home/node`.
+
+## Ports
+
+SSH on 2222. Exposed ports get public URLs automatically. Use 3000, 8000, 8080 for web servers.