added extra information on how to deploy charms and append to AGENTS.md in dockerfile, fixed formatting

Author: ellyxir

packages/ralph/DEPLOY.md

@@ -0,0 +1,88 @@
+# Deploying and Testing a Charm
+
+This guide provides step-by-step instructions for deploying a charm locally and
+testing it with Playwright.
+
+## Step 1: Create an Identity Key
+
+First, create an identity key if one doesn't exist:
+
+```bash
+NO_COLOR=1 deno task ct id new > my.key
+```
+
+This creates a new identity key file named `my.key` in the current directory.
+
+## Step 2: Deploy the Charm
+
+Deploy a charm to localhost using the `ct charm new` command:
+
+```bash
+deno task ct charm new --identity ./my.key --api-url http://127.0.0.1:8000 --space <SPACE_NAME> <PATH_TO_CHARM_FILE>
+```
+
+Example:
+
+```bash
+deno task ct charm new --identity ./my.key --api-url http://127.0.0.1:8000 --space ellyse ./packages/patterns/counter.tsx
+```
+
+The command will output a charm ID (e.g.,
+`baedreidon464mghox4uar46bbym5t6bnmlvn6wwzby5vvdmsw24oxaalp4`).
+
+## Step 3: Construct the URL
+
+The URL format for localhost is:
+
+```
+http://localhost:5173/<SPACE_NAME>/<CHARM_ID>
+```
+
+Example:
+
+```
+http://localhost:5173/ellyse/baedreidon464mghox4uar46bbym5t6bnmlvn6wwzby5vvdmsw24oxaalp4
+```
+
+## Step 4: Test with Playwright
+
+### 4.1 Navigate to the Charm URL
+
+```javascript
+await page.goto("http://localhost:5173/<SPACE_NAME>/<CHARM_ID>");
+```
+
+### 4.2 Register/Login (First Time Only)
+
+When you first visit, you'll see a login page. Register with a passphrase:
+
+1. Click the "➕ Register" button
+2. Click the "🔑 Generate Passphrase" button
+3. Click the "🔒 I've Saved It - Continue" button
+
+This will log you in and load the charm.
+
+### 4.3 Test the Charm
+
+Once logged in, you can interact with the charm using Playwright commands.
+
+## Complete Example
+
+```bash
+# 1. Create identity key (if needed)
+deno task ct id new > my.key
+
+# 2. Deploy charm
+deno task ct charm new --identity ./my.key --api-url http://127.0.0.1:8000 --space ellyse ./packages/patterns/counter.tsx
+
+# Output: baedreidon464mghox4uar46bbym5t6bnmlvn6wwzby5vvdmsw24oxaalp4
+
+# 3. URL will be:
+# http://localhost:5173/ellyse/baedreidon464mghox4uar46bbym5t6bnmlvn6wwzby5vvdmsw24oxaalp4
+```
+
+Then use Playwright to:
+
+1. Navigate to the URL
+2. Complete registration (first time)
+3. Test the charm functionality

packages/ralph/Dockerfile

@@ -71,6 +71,11 @@ WORKDIR /app
 RUN git clone https://github.com/commontoolsinc/labs.git /app/labs && \
     chown -R ralph:ralph /app/labs
 
+# Copy and append DEPLOY.md to AGENTS.md
+COPY --chown=ralph:ralph DEPLOY.md /tmp/DEPLOY.md
+RUN cat /tmp/DEPLOY.md >> /app/labs/AGENTS.md && \
+    rm /tmp/DEPLOY.md
+
 # Copy the startup script from local directory
 COPY --chown=ralph:ralph start-servers.sh /app/start-servers.sh
 RUN chmod +x /app/start-servers.sh

packages/ralph/README.md

@@ -1,4 +1,5 @@
 # README
+
 Docker container to run the Common Tools servers
 
 Ability to run [Ralph](https://ghuntley.com/ralph/)
@@ -8,44 +9,60 @@ Claude CLI and Codex are installed
 ## How to run Ralph
 
 Running Docker locally (not pushing changes to repositories):
+
 ```bash
 $ cd ./packages/ralph
 $ docker build -t ralph .
 $ docker run -d --name ralph ralph
-
 ```
+
 Note for `docker build`:
-* -t is for the tag, we use *ralph* here
+
+- -t is for the tag, we use _ralph_ here
 
 Note for `docker run`:
-* -d is for detached mode
-* --name gives it an easier name to use for connecting to it later
-* the last *ralph* referes to the build tag we used earlier
+
+- -d is for detached mode
+- --name gives it an easier name to use for connecting to it later
+- the last _ralph_ referes to the build tag we used earlier
 
 Connecting to the running container:
+
 ```bash
 $ docker exec -it ralph bash
 ```
+
 We are using the `--name ralph` we specified earlier to connect.
 
+Running Claude Code with all permissions:
+
+```bash
+$ claude --dangerously-skip-permissions
+```
+
 ## Removing ralph
+
 You must remove the existing version if you want to run a newer build:
+
 ```bash
 $ docker stop ralph
 $ docker rm ralph
 ```
 
 ## TODO
-* add playwright to codex
-* configure tailscale to start up
-* push a working image to a docker hub
-* update README to use image from dockerhub 
-* figure out how LLM tokens should be set for toolshed
-* DONE - Add codex and claude packages
-* DONE - write section how to run ralph in this file
-* DONE - git clone the common tools repositories
-* DONE - start up toolshed server
-* DONE - start up shell server
-* DONE - add playwright mcp to claude
-  * created ralph user since chrome doesnt like to run as root, probably better this way anyway
-  * made ralph sudoer
+
+- add playwright to codex
+- configure tailscale to start up
+- push a working image to a docker hub
+- update README to use image from dockerhub
+- figure out how LLM tokens should be set for toolshed
+- sandbox the container (network config)
+- DONE - Add codex and claude packages
+- DONE - write section how to run ralph in this file
+- DONE - git clone the common tools repositories
+- DONE - start up toolshed server
+- DONE - start up shell server
+- DONE - add playwright mcp to claude
+  - created ralph user since chrome doesnt like to run as root, probably better
+    this way anyway
+  - made ralph sudoer