@elisym/cli 0.4.0 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -9
- package/dist/index.js +306 -216
- package/dist/index.js.map +1 -1
- package/package.json +4 -2
package/README.md
CHANGED
|
@@ -89,15 +89,16 @@ docker run --rm -it \
|
|
|
89
89
|
|
|
90
90
|
## Commands
|
|
91
91
|
|
|
92
|
-
| Command | Description
|
|
93
|
-
| ------------------------------------ |
|
|
94
|
-
| `elisym init [name]` | Interactive wizard - create agent identity
|
|
95
|
-
| `elisym init [name] --config <path>` | Non-interactive - load fields from an `elisym.yaml` template
|
|
96
|
-
| `elisym init [name] --local` | Create in project `.elisym/<name>/` (default: `~/.elisym/<name>/`)
|
|
97
|
-
| `elisym start [name]` | Start agent in provider mode
|
|
98
|
-
| `elisym
|
|
99
|
-
| `elisym
|
|
100
|
-
| `elisym
|
|
92
|
+
| Command | Description |
|
|
93
|
+
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
94
|
+
| `elisym init [name]` | Interactive wizard - create agent identity |
|
|
95
|
+
| `elisym init [name] --config <path>` | Non-interactive - load fields from an `elisym.yaml` template |
|
|
96
|
+
| `elisym init [name] --local` | Create in project `.elisym/<name>/` (default: `~/.elisym/<name>/`) |
|
|
97
|
+
| `elisym start [name]` | Start agent in provider mode |
|
|
98
|
+
| `elisym start [name] --verbose` | Start with structured debug logs to stderr (publish acks, pool resets, heartbeat, config resolution). Also togglable via `ELISYM_DEBUG=1` or `LOG_LEVEL=debug`. |
|
|
99
|
+
| `elisym list` | List all agents (project-local + home-global) |
|
|
100
|
+
| `elisym profile [name]` | Edit agent profile, wallet, and LLM settings |
|
|
101
|
+
| `elisym wallet [name]` | Show Solana wallet balance |
|
|
101
102
|
|
|
102
103
|
Skills live inside each agent directory at `<agentDir>/skills/<skill-name>/SKILL.md`:
|
|
103
104
|
|
|
@@ -241,6 +242,23 @@ If you cannot make a side effect idempotent, document the risk clearly in the sk
|
|
|
241
242
|
|
|
242
243
|
See `skills-examples/` for working skills: `youtube-summary`, `github-repo`, `stock-price`, `whois-lookup`, `site-status`, `trending`, `general-assistant`.
|
|
243
244
|
|
|
245
|
+
## Troubleshooting
|
|
246
|
+
|
|
247
|
+
If `elisym start` prints `* Running. Press Ctrl+C to stop.` but no jobs ever arrive (common on WSL and Windows when outbound relay connectivity is blocked by the firewall or NAT), run with `--verbose`:
|
|
248
|
+
|
|
249
|
+
```
|
|
250
|
+
elisym start --verbose
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
The debug firehose on stderr includes:
|
|
254
|
+
|
|
255
|
+
- `config_resolved` - resolved agent dir, relays, RPC URL, Solana address.
|
|
256
|
+
- `publish_ack` / `publish_failed` - one per kind:0 profile event and per kind:31990 capability card. If every `publish_failed` row has `error: "Failed to publish to all N relays"`, outbound WebSocket to relays is being blocked.
|
|
257
|
+
- `pool_reset` with `reason: probe_failed` or `self_ping_failed` - the watchdog rebuilt the relay pool; sustained resets mean connectivity is unstable.
|
|
258
|
+
- `heartbeat_failed` - periodic republish calls are failing.
|
|
259
|
+
|
|
260
|
+
Optional deeper network diagnostics (DNS + TCP probe per relay host) are available via `ELISYM_NET_DIAG=1` (see `elisym start --help`).
|
|
261
|
+
|
|
244
262
|
## Commands
|
|
245
263
|
|
|
246
264
|
```bash
|