@tellet/create 0.8.0

package/dist/scaffold/project.d.ts

@@ -0,0 +1,44 @@
+interface AgentConfig {
+    id: string;
+    name: string;
+    role: string;
+    description: string;
+    systemPrompt: string;
+    model: string;
+}
+interface SiteContent {
+    tagline: string;
+    subtitle: string;
+    features: {
+        title: string;
+        description: string;
+        icon: string;
+    }[];
+    faq: {
+        question: string;
+        answer: string;
+    }[];
+    cta: string;
+}
+export type DeployTier = "quickstart" | "cloud" | "enterprise";
+interface ScaffoldOptions {
+    company: {
+        name: string;
+        description: string;
+        industry: string;
+    };
+    agents: AgentConfig[];
+    site: SiteContent;
+    provider: "anthropic" | "openai";
+    tier: DeployTier;
+    mode: "new" | "connect";
+    websiteUrl: string;
+    infra: {
+        anthropicKey: string;
+        openaiKey?: string;
+        supabaseUrl: string;
+        supabaseKey: string;
+    };
+}
+export declare function scaffoldProject(options: ScaffoldOptions): Promise<string>;
+export {};

package/dist/scaffold/project.js

@@ -0,0 +1,318 @@
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+export async function scaffoldProject(options) {
+    const { company, agents, site, provider, tier, mode, websiteUrl, infra } = options;
+    const slug = company.name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+    const projectDir = path.resolve(process.cwd(), slug);
+    if (await fs.pathExists(projectDir)) {
+        throw new Error(`Directory "${slug}" already exists`);
+    }
+    // Copy template
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const templateDir = path.resolve(__dirname, "..", "..", "template");
+    if (await fs.pathExists(templateDir)) {
+        await fs.copy(templateDir, projectDir);
+    }
+    else {
+        await fs.mkdirp(projectDir);
+    }
+    // Remove infra/ if not enterprise tier
+    if (tier !== "enterprise") {
+        await fs.remove(path.join(projectDir, "infra"));
+    }
+    // Remove Docker files if quickstart tier
+    if (tier === "quickstart") {
+        await fs.remove(path.join(projectDir, "Dockerfile"));
+        await fs.remove(path.join(projectDir, "docker-compose.yml"));
+        await fs.remove(path.join(projectDir, "railway.toml"));
+    }
+    // Connect mode: remove public site, keep dashboard + API + widget
+    if (mode === "connect") {
+        await fs.remove(path.join(projectDir, "app", "(site)"));
+        await fs.remove(path.join(projectDir, "components", "sections"));
+    }
+    // Ensure directory structure
+    const dirs = [
+        "app/(site)",
+        "app/(dashboard)/dashboard",
+        "app/(dashboard)/agents",
+        "app/(dashboard)/conversations",
+        "app/(dashboard)/settings",
+        "app/api/chat",
+        "app/api/agents",
+        "app/login",
+        "agents",
+        "channels",
+        "components/chat",
+        "components/dashboard",
+        "components/ui",
+        "lib/engine",
+        "lib/providers",
+        "lib/storage",
+        "supabase/migrations",
+    ];
+    for (const dir of dirs) {
+        await fs.mkdirp(path.join(projectDir, dir));
+    }
+    // Write tellet.json
+    const telletConfig = {
+        $schema: "https://tellet.com/schema/v1.json",
+        version: "1.0.0",
+        company: {
+            name: company.name,
+            description: company.description,
+            industry: company.industry,
+        },
+        engine: "default",
+        llm: {
+            provider,
+            defaultModel: provider === "openai" ? "gpt-4.1" : "claude-sonnet-4-6",
+            fallback: null,
+        },
+        agents: agents.map((a) => ({
+            id: a.id,
+            name: a.name,
+            role: a.role,
+            model: a.model,
+            channels: ["web_chat"],
+            tools: a.role === "customer_support" ? ["search_knowledge"] : [],
+        })),
+        tools: {
+            search_knowledge: {
+                type: "builtin",
+                description: "Search company knowledge base",
+            },
+        },
+        channels: {
+            web_chat: { enabled: true },
+            slack: { enabled: false },
+            email: { enabled: false },
+        },
+        mode,
+        storage: "supabase",
+        integrations: [],
+        ...(websiteUrl ? { websiteUrl } : {}),
+        ...(mode === "new" ? { site } : {}),
+    };
+    await fs.writeJSON(path.join(projectDir, "tellet.json"), telletConfig, {
+        spaces: 2,
+    });
+    // Write environment file
+    const envLines = [
+        `# Orchestrator (always Anthropic)`,
+        `ANTHROPIC_API_KEY=${infra.anthropicKey}`,
+    ];
+    if (infra.openaiKey) {
+        envLines.push(`OPENAI_API_KEY=${infra.openaiKey}`);
+    }
+    if (tier === "quickstart") {
+        envLines.push(`NEXT_PUBLIC_SUPABASE_URL=${infra.supabaseUrl}`, `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=${infra.supabaseKey}`);
+    }
+    else if (tier === "cloud") {
+        envLines.push(`DATABASE_URL=postgresql://tellet:tellet@localhost:5432/tellet`, `# For Railway: use the DATABASE_URL from Railway dashboard`);
+    }
+    else {
+        envLines.push(`DATABASE_URL=postgresql://tellet:tellet@localhost:5432/tellet`, `# AWS: CDK sets this automatically via Lambda environment`);
+    }
+    const envFileName = tier === "cloud" ? ".env" : ".env.local";
+    await fs.writeFile(path.join(projectDir, envFileName), envLines.join("\n") + "\n");
+    // Write agent files
+    for (const agent of agents) {
+        const agentFile = `import { defineAgent } from "@/lib/engine";
+
+export default defineAgent({
+  id: "${agent.id}",
+  name: "${agent.name}",
+  role: "${agent.role}",
+  model: "${agent.model}",
+  systemPrompt: ${JSON.stringify(agent.systemPrompt)},
+  channels: ["web_chat"],
+  tools: [],
+});
+`;
+        await fs.writeFile(path.join(projectDir, "agents", `${agent.id}.ts`), agentFile);
+    }
+    // Write agents/index.ts (registry)
+    const imports = agents
+        .map((a) => `import ${a.id} from "./${a.id}.js";`)
+        .join("\n");
+    const exports = agents.map((a) => `  ${a.id}`).join(",\n");
+    await fs.writeFile(path.join(projectDir, "agents", "index.ts"), `${imports}\n\nexport const agents = {\n${exports},\n};\n`);
+    // Write package.json
+    await fs.writeJSON(path.join(projectDir, "package.json"), {
+        name: slug,
+        version: "0.1.0",
+        private: true,
+        scripts: {
+            dev: "next dev",
+            build: "next build",
+            start: "next start",
+        },
+        dependencies: {
+            next: "^16.2.0",
+            react: "^19.2.0",
+            "react-dom": "^19.2.0",
+            "@anthropic-ai/sdk": "^0.80.0",
+            openai: "^6.32.0",
+            "@modelcontextprotocol/sdk": "^1.12.0",
+            "@supabase/supabase-js": "^2.99.0",
+            "@supabase/ssr": "^0.9.0",
+            tailwindcss: "^4.0.0",
+            "@tailwindcss/postcss": "^4.0.0",
+            "framer-motion": "^12.0.0",
+            clsx: "^2.1.0",
+            "tailwind-merge": "^3.0.0",
+        },
+        devDependencies: {
+            typescript: "^5.0.0",
+            "@types/node": "^22.0.0",
+            "@types/react": "^19.0.0",
+        },
+    }, { spaces: 2 });
+    // Write postcss.config.mjs
+    await fs.writeFile(path.join(projectDir, "postcss.config.mjs"), `/** @type {import('postcss-load-config').Config} */\nconst config = {\n  plugins: {\n    "@tailwindcss/postcss": {},\n  },\n};\n\nexport default config;\n`);
+    // Write DB migration
+    await fs.writeFile(path.join(projectDir, "supabase", "migrations", "001_initial.sql"), generateMigration(agents, company));
+    return projectDir;
+}
+function generateMigration(agents, company) {
+    const seedValues = agents
+        .map((a) => `('${a.id}', '${a.name}', '${a.role}', ${pgEscape(a.systemPrompt)}, '${a.model}', 'active', '{}')`)
+        .join(",\n");
+    return `-- tellet schema
+
+-- Companies (multi-company support)
+create table companies (
+  id uuid primary key default gen_random_uuid(),
+  name text not null,
+  description text,
+  industry text,
+  config jsonb default '{}',
+  created_at timestamptz default now()
+);
+
+insert into companies (id, name, description, industry) values
+('00000000-0000-0000-0000-000000000001', ${pgEscape(company.name)}, ${pgEscape(company.description)}, ${pgEscape(company.industry)});
+
+-- Knowledge Base (pgvector)
+create extension if not exists vector;
+
+create table documents (
+  id uuid primary key default gen_random_uuid(),
+  company_id uuid references companies(id) default '00000000-0000-0000-0000-000000000001',
+  title text not null,
+  content text not null,
+  embedding vector(1536),
+  category text default 'general',
+  metadata jsonb default '{}',
+  created_at timestamptz default now()
+);
+
+create index on documents using ivfflat (embedding vector_cosine_ops) with (lists = 50);
+
+create or replace function match_documents(
+  query_embedding vector(1536),
+  match_count int default 3,
+  match_threshold float default 0.5
+)
+returns table (id uuid, title text, content text, category text, similarity float)
+language sql stable
+as $$
+  select
+    d.id, d.title, d.content, d.category,
+    1 - (d.embedding <=> query_embedding) as similarity
+  from documents d
+  where 1 - (d.embedding <=> query_embedding) > match_threshold
+  order by d.embedding <=> query_embedding
+  limit match_count;
+$$;
+
+-- Core tables
+create table agents (
+  id text primary key,
+  company_id uuid references companies(id) default '00000000-0000-0000-0000-000000000001',
+  name text not null,
+  role text not null,
+  system_prompt text not null,
+  model text default 'claude-sonnet-4-6',
+  status text default 'active',
+  config jsonb default '{}',
+  created_at timestamptz default now()
+);
+
+create table conversations (
+  id uuid primary key default gen_random_uuid(),
+  agent_id text references agents(id),
+  channel text not null,
+  visitor_id text,
+  metadata jsonb default '{}',
+  created_at timestamptz default now()
+);
+
+create table messages (
+  id uuid primary key default gen_random_uuid(),
+  conversation_id uuid references conversations(id) on delete cascade,
+  role text not null check (role in ('user', 'assistant')),
+  content text not null,
+  tokens_used integer default 0,
+  created_at timestamptz default now()
+);
+
+create table activity_log (
+  id uuid primary key default gen_random_uuid(),
+  agent_id text references agents(id),
+  action text not null,
+  summary text,
+  cost_usd numeric(10,4) default 0,
+  metadata jsonb default '{}',
+  created_at timestamptz default now()
+);
+
+-- Indexes
+create index idx_conv_agent on conversations(agent_id);
+create index idx_msg_conv on messages(conversation_id);
+create index idx_activity_agent on activity_log(agent_id);
+create index idx_activity_time on activity_log(created_at desc);
+
+-- RLS
+alter table companies enable row level security;
+alter table documents enable row level security;
+alter table agents enable row level security;
+
+create policy "auth_all" on companies for all to authenticated using (true) with check (true);
+create policy "anon_read_companies" on companies for select to anon using (true);
+alter table conversations enable row level security;
+alter table messages enable row level security;
+alter table activity_log enable row level security;
+
+create policy "auth_all" on documents for all to authenticated using (true) with check (true);
+create policy "anon_read_docs" on documents for select to anon using (true);
+
+create policy "auth_all" on agents for all to authenticated using (true) with check (true);
+create policy "auth_all" on conversations for all to authenticated using (true) with check (true);
+create policy "auth_all" on messages for all to authenticated using (true) with check (true);
+create policy "auth_all" on activity_log for all to authenticated using (true) with check (true);
+
+create policy "anon_read_agents" on agents for select to anon using (status = 'active');
+create policy "anon_insert_conv" on conversations for insert to anon with check (channel = 'web_chat');
+create policy "anon_insert_msg" on messages for insert to anon with check (true);
+create policy "anon_read_msg" on messages for select to anon using (true);
+create policy "anon_read_conv" on conversations for select to anon using (true);
+create policy "anon_read_activity" on activity_log for select to anon using (true);
+
+-- Realtime
+alter publication supabase_realtime add table activity_log;
+alter publication supabase_realtime add table messages;
+
+-- Seed agents
+insert into agents (id, name, role, system_prompt, model, status, config) values
+${seedValues};
+`;
+}
+function pgEscape(str) {
+    return "'" + str.replace(/'/g, "''") + "'";
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@tellet/create",
+  "version": "0.8.0",
+  "description": "The open-source platform for running an Agentic Company",
+  "type": "module",
+  "bin": {
+    "create": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "agentic-company",
+    "tellet",
+    "cli",
+    "orchestrator",
+    "mcp",
+    "knowledge-base",
+    "ai-agents",
+    "no-code"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentic-company/create-tellet"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@clack/prompts": "^1.1.0",
+    "chalk": "^5.6.2",
+    "fs-extra": "^11.3.4",
+    "openai": "^6.32.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/template/Dockerfile

@@ -0,0 +1,35 @@
+FROM node:22-alpine AS base
+
+# Stage 1: Install dependencies
+FROM base AS deps
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm ci --omit=dev
+
+# Stage 2: Build
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+ENV NEXT_TELEMETRY_DISABLED=1
+RUN npm run build
+
+# Stage 3: Production
+FROM base AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+COPY --from=builder /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+EXPOSE 3000
+ENV PORT=3000
+ENV HOSTNAME="0.0.0.0"
+
+CMD ["node", "server.js"]

package/template/app/(dashboard)/agents/page.tsx

@@ -0,0 +1,14 @@
+import { createServerSupabase } from "@/lib/supabase";
+import { AgentsListClient } from "@/components/dashboard/AgentsListClient";
+
+export default async function AgentsPage() {
+  const supabase = await createServerSupabase();
+  const { data: agents } = await supabase.from("agents").select("*").order("created_at");
+
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-semibold tracking-tight">Agents</h1>
+      <AgentsListClient agents={agents || []} />
+    </div>
+  );
+}

package/template/app/(dashboard)/conversations/[id]/page.tsx

@@ -0,0 +1,103 @@
+import Link from "next/link";
+import { createServerSupabase } from "@/lib/supabase";
+import { cn } from "@/lib/utils";
+
+export default async function ConversationDetailPage({
+  params,
+}: {
+  params: Promise<{ id: string }>;
+}) {
+  const { id } = await params;
+  const supabase = await createServerSupabase();
+
+  const { data: conversation } = await supabase
+    .from("conversations")
+    .select("*, agents(name, role)")
+    .eq("id", id)
+    .single();
+
+  if (!conversation) {
+    return (
+      <div className="space-y-6">
+        <Link
+          href="/conversations"
+          className="text-sm text-text-tertiary hover:text-text-secondary transition-colors"
+        >
+          &larr; Back to conversations
+        </Link>
+        <div className="rounded-lg border border-dashed border-border bg-bg-secondary/20 p-8 text-center">
+          <p className="text-text-secondary text-sm">Conversation not found.</p>
+        </div>
+      </div>
+    );
+  }
+
+  const { data: messages } = await supabase
+    .from("messages")
+    .select("*")
+    .eq("conversation_id", id)
+    .order("created_at");
+
+  const agent = conversation.agents as { name: string; role: string };
+
+  return (
+    <div className="space-y-6">
+      <Link
+        href="/conversations"
+        className="text-sm text-text-tertiary hover:text-text-secondary transition-colors"
+      >
+        &larr; Back to conversations
+      </Link>
+
+      <div className="flex items-center gap-3">
+        <div className="w-10 h-10 rounded-full bg-accent/10 text-accent text-sm font-bold flex items-center justify-center">
+          {agent.name[0]}
+        </div>
+        <div>
+          <h1 className="text-xl font-semibold">{agent.name}</h1>
+          <p className="text-xs text-text-tertiary capitalize">
+            {agent.role.replace("_", " ")} &middot; {conversation.channel} &middot;{" "}
+            {new Date(conversation.created_at).toLocaleString()}
+          </p>
+        </div>
+      </div>
+
+      <div className="space-y-3 max-w-3xl">
+        {messages && messages.length > 0 ? (
+          messages.map((m) => (
+            <div
+              key={m.id}
+              className={cn(
+                "flex",
+                m.role === "user" ? "justify-end" : "justify-start"
+              )}
+            >
+              <div
+                className={cn(
+                  "rounded-xl px-4 py-3 max-w-[80%] text-sm leading-relaxed",
+                  m.role === "user"
+                    ? "bg-accent text-white"
+                    : "bg-bg-secondary text-text-primary border border-border"
+                )}
+              >
+                <p className="whitespace-pre-wrap">{m.content}</p>
+                <p
+                  className={cn(
+                    "text-[11px] mt-1",
+                    m.role === "user" ? "text-white/60" : "text-text-tertiary"
+                  )}
+                >
+                  {new Date(m.created_at).toLocaleTimeString()}
+                </p>
+              </div>
+            </div>
+          ))
+        ) : (
+          <div className="rounded-lg border border-dashed border-border bg-bg-secondary/20 p-8 text-center">
+            <p className="text-text-secondary text-sm">No messages in this conversation.</p>
+          </div>
+        )}
+      </div>
+    </div>
+  );
+}

package/template/app/(dashboard)/conversations/page.tsx

@@ -0,0 +1,50 @@
+import Link from "next/link";
+import { createServerSupabase } from "@/lib/supabase";
+
+export default async function ConversationsPage() {
+  const supabase = await createServerSupabase();
+  const { data: conversations } = await supabase
+    .from("conversations")
+    .select("*, agents(name), messages(count)")
+    .order("created_at", { ascending: false })
+    .limit(50);
+
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-semibold tracking-tight">Conversations</h1>
+      {conversations && conversations.length > 0 ? (
+        <div className="space-y-2">
+          {conversations.map((c) => (
+            <Link
+              key={c.id}
+              href={`/conversations/${c.id}`}
+              className="flex items-center gap-4 rounded-xl border border-border bg-bg-secondary/50 p-4 hover:border-border-hover transition-colors"
+            >
+              <div className="flex-1">
+                <span className="font-medium text-sm">
+                  {(c.agents as { name: string })?.name}
+                </span>
+                <span className="text-xs text-text-tertiary ml-2">
+                  via {c.channel}
+                </span>
+              </div>
+              <span className="text-xs text-text-secondary">
+                {(c.messages as { count: number }[])?.[0]?.count || 0} messages
+              </span>
+              <span className="text-xs text-text-tertiary">
+                {new Date(c.created_at).toLocaleString()}
+              </span>
+            </Link>
+          ))}
+        </div>
+      ) : (
+        <div className="rounded-lg border border-dashed border-border bg-bg-secondary/20 p-8 text-center">
+          <p className="text-text-secondary text-sm">No conversations yet.</p>
+          <p className="text-text-tertiary text-xs mt-2">
+            Start chatting with an agent from the Dashboard or your public site.
+          </p>
+        </div>
+      )}
+    </div>
+  );
+}