feat: add tags to headless (#957)

src/agent/create.ts

@@ -73,6 +73,8 @@ export interface CreateAgentOptions {
   >;
   /** Override values for preset blocks (label → value) */
   blockValues?: Record<string, string>;
+  /** Tags to organize and categorize the agent */
+  tags?: string[];
 }
 
 export async function createAgent(
@@ -290,6 +292,9 @@ export async function createAgent(
   if (isSubagent) {
     tags.push("role:subagent");
   }
+  if (options.tags && Array.isArray(options.tags)) {
+    tags.push(...options.tags);
+  }
 
   const agentDescription =
     options.description ?? `Letta Code agent created in ${process.cwd()}`;