@tloncorp/tlon-skill 0.1.2 → 0.1.4

package/README.md

@@ -24,12 +24,43 @@ curl -L https://registry.npmjs.org/@tloncorp/tlon-skill-linux-x64/-/tlon-skill-l
 
 ## Configuration
 
+**Option 1: CLI flags (highest priority)**
+```bash
+# Pass credentials directly
+tlon --url https://your-ship.tlon.network --ship ~your-ship --code sampel-ticlyt-migfun-falmel contacts self
+
+# Or use a config file
+tlon --config ~/ships/my-ship.json contacts self
+```
+
+Config file format:
+```json
+{"url": "https://your-ship.tlon.network", "ship": "~your-ship", "code": "sampel-ticlyt-migfun-falmel"}
+```
+
+**Option 2: Environment variables**
 ```bash
 export URBIT_URL="https://your-ship.tlon.network"
 export URBIT_SHIP="~your-ship"
 export URBIT_CODE="sampel-ticlyt-migfun-falmel"
 ```
 
+**Option 3: OpenClaw config**
+
+If you have OpenClaw configured with a Tlon channel, credentials are loaded automatically.
+
+## Multi-Ship Usage
+
+If you have credentials for multiple ships, you can operate on behalf of any of them by passing their credentials via CLI flags. This is useful for managing multiple identities, bot operations, or moon management:
+
+```bash
+# Act as a different ship
+tlon --config ~/ships/bot.json channels groups
+
+# Or pass credentials directly
+tlon --url https://bot.tlon.network --ship ~bot-ship --code bot-code contacts self
+```
+
 ## Usage
 
 ```bash

package/SKILL.md

@@ -25,13 +25,48 @@ Replace `darwin-arm64` with `darwin-x64` or `linux-x64` as needed.
 
 ## Configuration
 
-Set environment variables:
+**CLI Flags (highest priority):**
+```bash
+# Pass all three credentials directly
+tlon --url https://your-ship.tlon.network --ship ~your-ship --code sampel-ticlyt-migfun-falmel <command>
+
+# Or load from a JSON config file
+tlon --config ~/ships/my-ship.json <command>
+```
+
+Config file format: `{"url": "...", "ship": "~...", "code": "..."}`
+
+**Environment Variables:**
 ```bash
 export URBIT_URL="https://your-ship.tlon.network"
 export URBIT_SHIP="~your-ship"
 export URBIT_CODE="sampel-ticlyt-migfun-falmel"
 ```
 
+**OpenClaw:** If configured with a Tlon channel, credentials load automatically.
+
+**Resolution order:** CLI flags → `TLON_CONFIG_FILE` → `TLON_SHIP`+`TLON_SKILL_DIR` → `URBIT_*` env vars → OpenClaw config
+
+## Multi-Ship Usage
+
+If you have credentials for multiple ships, you can use this skill to operate on behalf of any of them. This is useful for:
+
+- **Managing multiple identities** — switch between ships without changing environment variables
+- **Bot operations** — act as a bot ship while authenticated as yourself
+- **Moon management** — operate moons from their parent planet
+
+Simply pass the target ship's credentials via CLI flags:
+
+```bash
+# Post to a channel as ~other-ship
+tlon --url https://other-ship.tlon.network --ship ~other-ship --code their-access-code \
+  posts send chat/~host/channel "Hello from other-ship"
+
+# Or keep credentials in config files
+tlon --config ~/ships/bot.json channels groups
+tlon --config ~/ships/moon.json contacts self
+```
+
 ## Commands
 
 ### Activity
@@ -160,6 +195,16 @@ tlon notebook diary/~host/slug "Title" --content file.md # Post from file
 tlon notebook diary/~host/slug "Title" --image <url>     # Post with image
 ```
 
+### Upload
+
+Upload images to Tlon storage.
+
+```bash
+tlon upload https://example.com/image.png    # Upload image from URL
+```
+
+Returns the uploaded image URL for use in posts, profiles, etc.
+
 ### Settings (OpenClaw)
 
 Manage OpenClaw's Tlon plugin config via Urbit settings-store. Changes apply immediately without gateway restart.

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tloncorp/tlon-skill",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Tlon/Urbit skill for OpenClaw agents",
   "type": "module",
   "bin": {
-    "tlon-run": "./bin/tlon-run.js"
+    "tlon": "./bin/tlon.js"
   },
   "files": [
     "bin/",
@@ -17,9 +17,10 @@
     "test": "bun test"
   },
   "optionalDependencies": {
-    "@tloncorp/tlon-skill-darwin-arm64": "0.1.2",
-    "@tloncorp/tlon-skill-darwin-x64": "0.1.2",
-    "@tloncorp/tlon-skill-linux-x64": "0.1.2"
+    "@tloncorp/tlon-skill-darwin-arm64": "0.1.3",
+    "@tloncorp/tlon-skill-darwin-x64": "0.1.3",
+    "@tloncorp/tlon-skill-linux-x64": "0.1.3",
+    "@tloncorp/tlon-skill-linux-arm64": "0.1.3"
   },
   "devDependencies": {
     "@tloncorp/api": "git+https://github.com/tloncorp/api-beta.git#main",