shadok-ai 0.2.53 → 0.2.54

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.
Files changed (2) hide show
  1. package/README.md +24 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -122,6 +122,30 @@ from the board group's creator, so an instance that already has an owner never
122
122
  hands itself to whoever messages next — a bot username is public, and a DM is a
123
123
  shell.
124
124
 
125
+ ### Running in Docker
126
+
127
+ The repo ships an official `Dockerfile`:
128
+
129
+ ```bash
130
+ docker build -t shadok-ai .
131
+ docker run -d --name shadok-ai --restart unless-stopped \
132
+ -p 127.0.0.1:3789:3789 \
133
+ -v shadok-data:/root/.shadok-ai \
134
+ -v shadok-claude:/root/.claude \
135
+ -v shadok-workspace:/workspace \
136
+ -e SHADOK_HOST=0.0.0.0 -e SHADOK_GUI_PASSWORD=change-me \
137
+ shadok-ai
138
+ ```
139
+
140
+ The image bundles **Claude Code**, **shadok-ai** and a **headless browser**
141
+ (Playwright Chromium, at `PLAYWRIGHT_BROWSERS_PATH=/opt/playwright-browsers`) so
142
+ an agent can screenshot or drive the web with no first-run download; `git`, `gh`,
143
+ `tmux`, `jq` and a C toolchain are there for agents' own work. The three volumes
144
+ are what survive `docker restart` **and** `docker rm`+recreate: `~/.shadok-ai`
145
+ (vault, profiles, channels, crons, SSH identity), `~/.claude` (credentials,
146
+ transcripts), `/workspace` (agents' files). A fresh container needs a one-time
147
+ Claude login: `docker exec -it shadok-ai claude`.
148
+
125
149
  ### Exposing it beyond this machine
126
150
 
127
151
  The cockpit runs arbitrary commands on the host by design, so it binds
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "shadok-ai",
3
- "version": "0.2.53",
3
+ "version": "0.2.54",
4
4
  "main": "dist/session.js",
5
5
  "scripts": {
6
6
  "test": "node --import tsx --test test/*.ts .claude/skills/shadok-ai-agents/test/*.test.mjs",