@bytespell/shella 0.1.0 → 0.1.2

package/README.md

@@ -9,11 +9,19 @@ Run multiple AI agents in parallel, persist sessions across devices, and manage
 ### npx (Developers)
 
 ```bash
+# From your project directory
+cd ~/myproject
 npx @bytespell/shella
 ```
 
 Opens at `http://localhost:3067`. Access from your phone using the LAN IP shown.
 
+For multiple projects:
+
+```bash
+npx @bytespell/shella --projects-dir ~/code
+```
+
 ### Docker (Homelab)
 
 ```yaml
@@ -24,8 +32,9 @@ services:
     ports:
       - '3067:3067'
     volumes:
-      - /path/to/projects:/project
+      - ~/code:/project
       - shella-data:/root/.config/shella
+    command: ['--projects-dir', '/project']
     restart: unless-stopped
 
 volumes:
@@ -47,11 +56,12 @@ docker compose up -d
 ## CLI Options
 
 ```bash
-shella                           # Start with defaults
-shella --port 3000               # Custom web port
-shella --opencode-port 5000      # Custom OpenCode port
-shella --no-open                 # Don't open browser
-shella --help                    # Show help
+shella                              # Start (registers current directory)
+shella --projects-dir ~/code        # Register all subdirs of ~/code
+shella --port 3000                  # Custom web port
+shella --opencode-port 5000         # Custom OpenCode port
+shella --no-open                    # Don't open browser
+shella --help                       # Show help
 ```
 
 ## Development

package/bin/cli.js

@@ -4,10 +4,17 @@ import { createOpencodeServer } from '@opencode-ai/sdk';
 import { networkInterfaces } from 'os';
 import { spawn } from 'child_process';
 import { createConnection } from 'net';
+import { existsSync, readdirSync } from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const VERSION = '0.1.0';
+const VERSION = '0.1.2';
+/**
+ * Check if running inside Docker container
+ */
+function isDocker() {
+    return existsSync('/.dockerenv');
+}
 /**
  * Check if a port is available
  */
@@ -64,12 +71,63 @@ function printAccessBox(lanIp, port) {
 +${border}+
 `);
 }
+/**
+ * Register projects with OpenCode
+ */
+async function registerProjects(opencodePort, projectsDir) {
+    const baseUrl = `http://localhost:${opencodePort}`;
+    if (projectsDir) {
+        // Resolve to absolute path
+        const absDir = path.resolve(projectsDir);
+        if (!existsSync(absDir)) {
+            console.error(`Error: Projects directory not found: ${absDir}`);
+            process.exit(1);
+        }
+        // Register each subdirectory
+        const entries = readdirSync(absDir, { withFileTypes: true });
+        const dirs = entries.filter((e) => e.isDirectory() && !e.name.startsWith('.'));
+        if (dirs.length === 0) {
+            console.error(`Error: No project directories found in ${absDir}`);
+            process.exit(1);
+        }
+        for (const entry of dirs) {
+            const dir = path.join(absDir, entry.name);
+            try {
+                await fetch(`${baseUrl}/project?directory=${encodeURIComponent(dir)}`);
+                console.log(`  Registered: ${entry.name}`);
+            }
+            catch (err) {
+                console.error(`  Failed to register ${entry.name}: ${err}`);
+            }
+        }
+    }
+    else {
+        // Register cwd
+        const dir = process.cwd();
+        try {
+            await fetch(`${baseUrl}/project?directory=${encodeURIComponent(dir)}`);
+            console.log(`  Registered: ${path.basename(dir)}`);
+        }
+        catch (err) {
+            console.error(`  Failed to register ${path.basename(dir)}: ${err}`);
+        }
+    }
+}
 let opencodeServer = null;
 let expressProcess = null;
 async function startCommand(options) {
     const port = parseInt(options.port);
     const opencodePort = parseInt(options.opencodePort);
     console.log(`Shella v${VERSION}\n`);
+    // Docker requires --projects-dir
+    if (isDocker() && !options.projectsDir) {
+        console.error('Error: --projects-dir is required when running in Docker.\n');
+        console.error('Example:');
+        console.error('  docker run -v ~/code:/project shella --projects-dir /project\n');
+        console.error('Or in docker-compose.yml:');
+        console.error('  command: ["--projects-dir", "/project"]');
+        process.exit(1);
+    }
     // Check if ports are available
     const webPortAvailable = await isPortAvailable(port);
     const ocPortAvailable = await isPortAvailable(opencodePort);
@@ -106,6 +164,9 @@ async function startCommand(options) {
         }
         process.exit(1);
     }
+    // Register projects with OpenCode
+    console.log('Registering projects...');
+    await registerProjects(opencodePort, options.projectsDir);
     // Start Express server in production mode
     console.log('Starting Shella server...');
     const serverPath = path.join(__dirname, '..', 'dist', 'server', 'index.js');
@@ -186,6 +247,7 @@ program
     .description('Start Shella')
     .option('-p, --port <port>', 'Web server port', '3067')
     .option('--opencode-port <port>', 'OpenCode server port', '4096')
+    .option('--projects-dir <path>', 'Directory containing projects (each subdirectory becomes a project)')
     .option('--no-open', "Don't open browser automatically")
     .action(startCommand);
 program.parse();

package/dist/web/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" rx="4" fill="#1a1a1a"/>
+  <text x="16" y="23" font-family="monospace" font-size="18" font-weight="bold" fill="#22c55e" text-anchor="middle">S</text>
+</svg>

package/dist/web/index.html

@@ -2,7 +2,7 @@
 <html lang="en" class="dark">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
     <meta
       name="viewport"
       content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@bytespell/shella",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Self-hosted AI coding agents. Access from your phone.",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bytespell-oss/shella"
+  },
   "bin": {
-    "shella": "./bin/cli.js"
+    "shella": "bin/cli.js"
   },
   "files": [
     "dist/",