feat(cli): store serverUrl in config during init; auto-connect LAN clients

README.md

@@ -35,17 +35,18 @@ agenthub init
 agenthub server start --host 0.0.0.0 --port 3377
 ```
 
-On another machine (e.g. Windows):
+On another machine (e.g. Windows) run `init` once and point it at the host:
 
 ```powershell
-$env:AGENTHUB_SERVER="http://<mac-ip>:3377"
+cd my-project
+agenthub init --server http://<mac-ip>:3377
 agenthub task create --title "Windows task" --role implementer
 agenthub status
 ```
 
-Use `--server http://<ip>:3377` on each command instead of the environment variable if you prefer.
+After `init`, every command automatically talks to the configured server. You can still override it per command with `--server http://<ip>:3377` or via the `AGENTHUB_SERVER` environment variable.
 
-`init` always runs locally on the host machine.
+The `init --server` step only stores the server URL locally; it does not create a second project. The host machine keeps the single source of truth.
 
 ## License
 

src/cli/commands/init.ts

@@ -3,9 +3,12 @@ import { join } from 'path';
 import { getAgentHubDir } from '../../core/paths.js';
 import { saveConfig, defaultConfig } from '../../core/config.js';
 import { agentsMd, claudeMd, codexMd, kimiMd } from '../../core/templates.js';
-import { askProjectName, askAgents, askDelegationMode } from '../prompts.js';
+import { askProjectName, askAgents, askDelegationMode, askServerUrl } from '../prompts.js';
 
-export async function init(cwd: string, options: { projectName?: string; yes?: boolean }): Promise<void> {
+export async function init(
+  cwd: string,
+  options: { projectName?: string; yes?: boolean; server?: string },
+): Promise<void> {
   const projectName = options.projectName ?? (options.yes ? getDefaultProjectName(cwd) : await askProjectName(getDefaultProjectName(cwd)));
 
   const { claude, codex, kimi } = options.yes
@@ -14,8 +17,11 @@ export async function init(cwd: string, options: { projectName?: string; yes?: b
 
   const mode = options.yes ? 'suggest' : await askDelegationMode();
 
+  const serverUrl = options.server ?? (options.yes ? undefined : await askServerUrl());
+
   const config = defaultConfig(projectName);
   config.delegationMode = mode;
+  if (serverUrl) config.serverUrl = serverUrl;
 
   const dir = getAgentHubDir(cwd);
   mkdirSync(join(dir, 'tasks'), { recursive: true });
@@ -32,6 +38,9 @@ export async function init(cwd: string, options: { projectName?: string; yes?: b
   if (kimi) writeFileSync(join(cwd, 'KIMI.md'), kimiMd(), 'utf-8');
 
   console.log(`AgentHub initialized for "${projectName}".`);
+  if (serverUrl) {
+    console.log(`Connected to remote server at ${serverUrl}.`);
+  }
   console.log('Run `agenthub status` to see the current project state.');
 }
 

src/cli/index.ts

@@ -7,10 +7,18 @@ import { handoffCreate, handoffRead, handoffList } from './commands/handoff.js';
 import { decisionCreate, decisionList } from './commands/decision.js';
 import { delegate } from './commands/delegate.js';
 import { serverStart } from './commands/server.js';
+import { loadConfig } from '../core/config.js';
 import { remoteClient, RemoteError } from './remoteClient.js';
 
-function getServerUrl(program: Command): string | undefined {
+function getServerUrl(program: Command, cwd: string): string | undefined {
-  return (program.opts().server as string | undefined) || process.env.AGENTHUB_SERVER;
+  const flag = (program.opts().server as string | undefined) || process.env.AGENTHUB_SERVER;
+  if (flag) return flag;
+  try {
+    const config = loadConfig(cwd);
+    return config.serverUrl;
+  } catch {
+    return undefined;
+  }
 }
 
 function remoteOnly(): never {
@@ -45,9 +53,9 @@ export function createProgram(cwd: string): Command {
     .description('Initialize AgentHub in the current directory')
     .option('-n, --project-name <name>', 'Project name')
     .option('-y, --yes', 'Use defaults without prompts')
+    .option('--server <url>', 'Connect to a remote AgentHub server (stored in config)')
     .action((options) => {
-      if (getServerUrl(program)) remoteOnly();
+      init(cwd, { ...options, server: options.server || (program.opts().server as string | undefined) });
-      init(cwd, options);
     });
 
   program
@@ -55,7 +63,7 @@ export function createProgram(cwd: string): Command {
     .description('Show project status')
     .option('-u, --update', 'Regenerate status before showing')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const body = options.update ? await remoteClient.updateStatus(serverUrl) : await remoteClient.getStatus(serverUrl);
@@ -74,7 +82,7 @@ export function createProgram(cwd: string): Command {
     .option('--category <category>', 'Category')
     .option('--content <content>', 'Content')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const memory = await remoteClient.addMemory(serverUrl, options);
@@ -88,7 +96,7 @@ export function createProgram(cwd: string): Command {
     .command('search <query>')
     .description('Search memory and tasks')
     .action(async (query) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const results = await remoteClient.searchMemory(serverUrl, query);
@@ -103,7 +111,7 @@ export function createProgram(cwd: string): Command {
     .command('list')
     .description('List memory entries')
     .action(async () => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const memories = await remoteClient.listMemory(serverUrl);
@@ -124,7 +132,7 @@ export function createProgram(cwd: string): Command {
     .option('--role <role>', 'Role')
     .option('--priority <priority>', 'Priority')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const task = await remoteClient.createTask(serverUrl, options);
@@ -140,7 +148,7 @@ export function createProgram(cwd: string): Command {
     .option('--status <status>', 'Filter by status')
     .option('--role <role>', 'Filter by role')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const tasks = await remoteClient.listTasks(serverUrl, options);
@@ -155,7 +163,7 @@ export function createProgram(cwd: string): Command {
     .command('show <id>')
     .description('Show a task')
     .action(async (id) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const { task, body } = await remoteClient.getTask(serverUrl, id);
@@ -172,7 +180,7 @@ export function createProgram(cwd: string): Command {
     .description('Claim a task')
     .requiredOption('--agent <agent>', 'Agent name')
     .action(async (id, options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           await remoteClient.claimTask(serverUrl, id, options.agent);
@@ -186,7 +194,7 @@ export function createProgram(cwd: string): Command {
     .command('done <id>')
     .description('Mark a task as done')
     .action(async (id) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           await remoteClient.doneTask(serverUrl, id);
@@ -208,7 +216,7 @@ export function createProgram(cwd: string): Command {
     .option('--summary <summary>', 'Summary')
     .option('--context <context>', 'Context')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const handoff = await remoteClient.createHandoff(serverUrl, options);
@@ -222,7 +230,7 @@ export function createProgram(cwd: string): Command {
     .command('read <id>')
     .description('Read a handoff')
     .action(async (id) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const { handoff, body } = await remoteClient.getHandoff(serverUrl, id);
@@ -239,7 +247,7 @@ export function createProgram(cwd: string): Command {
     .command('list')
     .description('List handoffs')
     .action(async () => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const handoffs = await remoteClient.listHandoffs(serverUrl);
@@ -260,7 +268,7 @@ export function createProgram(cwd: string): Command {
     .option('--context <context>', 'Context')
     .option('--decision <decision>', 'Decision')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const decision = await remoteClient.createDecision(serverUrl, options);
@@ -274,7 +282,7 @@ export function createProgram(cwd: string): Command {
     .command('list')
     .description('List decisions')
     .action(async () => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const decisions = await remoteClient.listDecisions(serverUrl);
@@ -292,7 +300,7 @@ export function createProgram(cwd: string): Command {
     .description('Suggest or auto-delegate open tasks')
     .option('--auto', 'Create handoff automatically')
     .action(async (options) => {
-      const serverUrl = getServerUrl(program);
+      const serverUrl = getServerUrl(program, cwd);
       if (serverUrl) {
         await runRemote(serverUrl, async () => {
           const result = await remoteClient.delegate(serverUrl, options.auto ?? false);

src/cli/prompts.ts

@@ -22,3 +22,22 @@ export async function askDelegationMode(): Promise<'manual' | 'suggest' | 'auto'
     default: 'suggest',
   });
 }
+
+export async function askServerUrl(): Promise<string | undefined> {
+  const connect = await confirm({
+    message: 'Connect to an existing AgentHub server on the LAN?',
+    default: false,
+  });
+  if (!connect) return undefined;
+  return input({
+    message: 'Server URL (e.g. http://192.168.1.10:3377):',
+    validate: (value) => {
+      try {
+        new URL(value);
+        return true;
+      } catch {
+        return 'Please enter a valid URL.';
+      }
+    },
+  });
+}

src/core/config.ts

@@ -14,6 +14,7 @@ export function defaultConfig(projectName: string): Config {
       reviewer: { preferredAgent: 'claude' },
       tester: { preferredAgent: 'codex' },
     },
+    serverUrl: undefined,
   };
 }
 

src/core/schema.ts

@@ -82,6 +82,7 @@ export const ConfigSchema = z.object({
   projectName: z.string().min(1),
   delegationMode: DelegationMode.default('suggest'),
   roles: z.record(z.string(), RoleConfigSchema),
+  serverUrl: z.string().url().optional(),
 });
 
 export type Task = z.infer<typeof TaskSchema>;