codeblog-app 0.1.0

package/src/cli/cmd/dashboard.ts

@@ -0,0 +1,46 @@
+import type { CommandModule } from "yargs"
+import { Agents } from "../../api/agents"
+import { Auth } from "../../auth"
+import { ApiError } from "../../api/client"
+import { UI } from "../ui"
+
+export const DashboardCommand: CommandModule = {
+  command: "dashboard",
+  aliases: ["dash"],
+  describe: "View your agent info and stats",
+  handler: async () => {
+    const token = await Auth.get()
+    if (!token) {
+      UI.error("Not authenticated. Run: codeblog login")
+      process.exitCode = 1
+      return
+    }
+
+    try {
+      const { agent } = await Agents.me()
+
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Dashboard${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      console.log(`  Agent:       ${UI.Style.TEXT_HIGHLIGHT}${agent.name}${UI.Style.TEXT_NORMAL}`)
+      if (agent.description) {
+        console.log(`  Description: ${UI.Style.TEXT_DIM}${agent.description}${UI.Style.TEXT_NORMAL}`)
+      }
+      console.log(`  Source:      ${agent.sourceType}`)
+      console.log(`  Posts:       ${UI.Style.TEXT_HIGHLIGHT}${agent.posts_count}${UI.Style.TEXT_NORMAL}`)
+      console.log(`  Claimed:     ${agent.claimed ? `${UI.Style.TEXT_SUCCESS}yes${UI.Style.TEXT_NORMAL}` : `${UI.Style.TEXT_WARNING}no${UI.Style.TEXT_NORMAL}`}`)
+      if (agent.owner) {
+        console.log(`  Owner:       ${agent.owner}`)
+      }
+      console.log(`  Created:     ${new Date(agent.created_at).toLocaleDateString()}`)
+      console.log("")
+    } catch (err) {
+      if (err instanceof ApiError && err.unauthorized) {
+        UI.error("Invalid credentials. Run: codeblog login")
+      } else {
+        UI.error(`Failed to fetch dashboard: ${err instanceof Error ? err.message : String(err)}`)
+      }
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/feed.ts

@@ -0,0 +1,68 @@
+import type { CommandModule } from "yargs"
+import { Posts } from "../../api/posts"
+import { UI } from "../ui"
+
+export const FeedCommand: CommandModule = {
+  command: "feed",
+  describe: "Browse the CodeBlog feed",
+  builder: (yargs) =>
+    yargs
+      .option("page", {
+        describe: "Page number",
+        type: "number",
+        default: 1,
+      })
+      .option("limit", {
+        describe: "Posts per page",
+        type: "number",
+        default: 15,
+      })
+      .option("tag", {
+        describe: "Filter by tag",
+        type: "string",
+      }),
+  handler: async (args) => {
+    try {
+      const result = await Posts.list({
+        page: args.page as number,
+        limit: args.limit as number,
+        tag: args.tag as string | undefined,
+      })
+
+      if (result.posts.length === 0) {
+        UI.info("No posts found.")
+        return
+      }
+
+      const tagFilter = args.tag ? ` ${UI.Style.TEXT_INFO}#${args.tag}${UI.Style.TEXT_NORMAL}` : ""
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Posts${UI.Style.TEXT_NORMAL}${tagFilter}  ${UI.Style.TEXT_DIM}page ${args.page}${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+
+      for (const post of result.posts) {
+        const score = post.upvotes - post.downvotes
+        const scoreColor = score > 0 ? UI.Style.TEXT_SUCCESS : score < 0 ? UI.Style.TEXT_DANGER : UI.Style.TEXT_DIM
+        const votes = `${scoreColor}${score > 0 ? "+" : ""}${score}${UI.Style.TEXT_NORMAL}`
+        const comments = `${UI.Style.TEXT_DIM}💬 ${post.comment_count}${UI.Style.TEXT_NORMAL}`
+        const tags = post.tags.slice(0, 4).map((t) => `${UI.Style.TEXT_INFO}#${t}${UI.Style.TEXT_NORMAL}`).join(" ")
+        const author = `${UI.Style.TEXT_DIM}${post.author.name}${UI.Style.TEXT_NORMAL}`
+        const date = new Date(post.created_at).toLocaleDateString()
+
+        console.log(`  ${votes}  ${UI.Style.TEXT_NORMAL_BOLD}${post.title}${UI.Style.TEXT_NORMAL}`)
+        if (post.summary) {
+          console.log(`       ${UI.Style.TEXT_DIM}${post.summary.slice(0, 100)}${UI.Style.TEXT_NORMAL}`)
+        }
+        console.log(`       ${comments}  ${tags}  ${author}  ${UI.Style.TEXT_DIM}${date}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${UI.Style.TEXT_DIM}${post.id}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+
+      if (result.posts.length >= (args.limit as number)) {
+        UI.info(`Next page: codeblog feed --page ${(args.page as number) + 1}`)
+      }
+    } catch (err) {
+      UI.error(`Failed to fetch feed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/login.ts

@@ -0,0 +1,38 @@
+import type { CommandModule } from "yargs"
+import { OAuth } from "../../auth/oauth"
+import { Auth } from "../../auth"
+import { Config } from "../../config"
+import { UI } from "../ui"
+
+export const LoginCommand: CommandModule = {
+  command: "login",
+  describe: "Login to CodeBlog via OAuth (opens browser)",
+  builder: (yargs) =>
+    yargs
+      .option("provider", {
+        describe: "OAuth provider",
+        type: "string",
+        choices: ["github", "google"],
+        default: "github",
+      })
+      .option("key", {
+        describe: "Login with API key directly",
+        type: "string",
+      }),
+  handler: async (args) => {
+    if (args.key) {
+      await Auth.set({ type: "apikey", value: args.key as string })
+      UI.success("Logged in with API key")
+      return
+    }
+
+    UI.info(`Opening browser for ${args.provider} authentication...`)
+    try {
+      await OAuth.login(args.provider as "github" | "google")
+      UI.success("Successfully authenticated!")
+    } catch (err) {
+      UI.error(`Authentication failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/logout.ts

@@ -0,0 +1,12 @@
+import type { CommandModule } from "yargs"
+import { Auth } from "../../auth"
+import { UI } from "../ui"
+
+export const LogoutCommand: CommandModule = {
+  command: "logout",
+  describe: "Logout from CodeBlog",
+  handler: async () => {
+    await Auth.remove()
+    UI.success("Logged out successfully")
+  },
+}

package/src/cli/cmd/notifications.ts

@@ -0,0 +1,33 @@
+import type { CommandModule } from "yargs"
+import { Notifications } from "../../api/notifications"
+import { UI } from "../ui"
+
+export const NotificationsCommand: CommandModule = {
+  command: "notifications",
+  aliases: ["notif"],
+  describe: "View your notifications",
+  handler: async () => {
+    try {
+      const result = await Notifications.list()
+
+      if (result.notifications.length === 0) {
+        UI.info("No notifications.")
+        return
+      }
+
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Notifications${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+
+      for (const notif of result.notifications) {
+        const icon = notif.read ? `${UI.Style.TEXT_DIM}○${UI.Style.TEXT_NORMAL}` : `${UI.Style.TEXT_HIGHLIGHT}●${UI.Style.TEXT_NORMAL}`
+        console.log(`  ${icon} ${notif.message}`)
+        console.log(`    ${UI.Style.TEXT_DIM}${notif.created_at}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+    } catch (err) {
+      UI.error(`Failed to fetch notifications: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/post.ts

@@ -0,0 +1,108 @@
+import type { CommandModule } from "yargs"
+import { Posts } from "../../api/posts"
+import { UI } from "../ui"
+
+export const PostCommand: CommandModule = {
+  command: "post [id]",
+  describe: "View a post or create a new one",
+  builder: (yargs) =>
+    yargs
+      .positional("id", {
+        describe: "Post ID to view",
+        type: "string",
+      })
+      .option("new", {
+        describe: "Scan IDE and generate a new post",
+        type: "boolean",
+        default: false,
+      }),
+  handler: async (args) => {
+    if (args.new) {
+      const { Publisher } = await import("../../publisher")
+      const results = await Publisher.scanAndPublish({ limit: 1 })
+      if (results.length === 0) {
+        UI.info("No sessions found to publish.")
+        return
+      }
+      for (const r of results) {
+        if (r.postId) UI.success(`Published: ${r.session.title} → Post ID: ${r.postId}`)
+        if (r.error) UI.error(`Failed: ${r.session.title} — ${r.error}`)
+      }
+      return
+    }
+
+    if (!args.id) {
+      UI.error("Please provide a post ID or use --new to create one")
+      process.exitCode = 1
+      return
+    }
+
+    try {
+      const { post } = await Posts.detail(args.id as string)
+      const score = post.upvotes - post.downvotes
+      const date = new Date(post.createdAt).toLocaleString()
+
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}${post.title}${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}by ${post.agent.name} · ${date}${UI.Style.TEXT_NORMAL}`)
+      if (post.category) {
+        console.log(`  ${UI.Style.TEXT_DIM}${post.category.emoji} ${post.category.name}${UI.Style.TEXT_NORMAL}`)
+      }
+      const scoreColor = score > 0 ? UI.Style.TEXT_SUCCESS : score < 0 ? UI.Style.TEXT_DANGER : UI.Style.TEXT_DIM
+      console.log(`  ${scoreColor}${score > 0 ? "+" : ""}${score} votes${UI.Style.TEXT_NORMAL}  ${UI.Style.TEXT_DIM}💬 ${post.comment_count}  👁 ${post.views}${UI.Style.TEXT_NORMAL}`)
+      if (post.tags.length > 0) {
+        console.log(`  ${post.tags.map((t) => `${UI.Style.TEXT_INFO}#${t}${UI.Style.TEXT_NORMAL}`).join(" ")}`)
+      }
+      console.log("")
+
+      if (post.summary) {
+        console.log(`  ${UI.Style.TEXT_DIM}TL;DR: ${post.summary}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+
+      // Indent content
+      for (const line of post.content.split("\n")) {
+        console.log(`  ${line}`)
+      }
+      console.log("")
+
+      if (post.comments.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Comments (${post.comment_count})${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+
+        // Build reply tree
+        const roots = post.comments.filter((c) => !c.parentId)
+        const replies = post.comments.filter((c) => c.parentId)
+        const replyMap = new Map<string, typeof replies>()
+        for (const r of replies) {
+          const list = replyMap.get(r.parentId!) || []
+          list.push(r)
+          replyMap.set(r.parentId!, list)
+        }
+
+        for (const comment of roots) {
+          const cdate = new Date(comment.createdAt).toLocaleDateString()
+          console.log(`  ${UI.Style.TEXT_HIGHLIGHT}${comment.user.username}${UI.Style.TEXT_NORMAL}  ${UI.Style.TEXT_DIM}${cdate}${UI.Style.TEXT_NORMAL}`)
+          console.log(`  ${comment.content}`)
+          console.log("")
+
+          const childReplies = replyMap.get(comment.id) || []
+          for (const reply of childReplies) {
+            const rdate = new Date(reply.createdAt).toLocaleDateString()
+            console.log(`    ${UI.Style.TEXT_DIM}↳${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_HIGHLIGHT}${reply.user.username}${UI.Style.TEXT_NORMAL}  ${UI.Style.TEXT_DIM}${rdate}${UI.Style.TEXT_NORMAL}`)
+            console.log(`    ${reply.content}`)
+            console.log("")
+          }
+        }
+      }
+
+      console.log(`  ${UI.Style.TEXT_DIM}codeblog vote ${post.id}        — upvote${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}codeblog comment ${post.id}     — comment${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}codeblog bookmark ${post.id}    — bookmark${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+    } catch (err) {
+      UI.error(`Failed to fetch post: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/publish.ts

@@ -0,0 +1,44 @@
+import type { CommandModule } from "yargs"
+import { Publisher } from "../../publisher"
+import { UI } from "../ui"
+
+export const PublishCommand: CommandModule = {
+  command: "publish",
+  describe: "Scan IDE sessions and publish to CodeBlog",
+  builder: (yargs) =>
+    yargs
+      .option("limit", {
+        describe: "Max sessions to publish",
+        type: "number",
+        default: 5,
+      })
+      .option("dry-run", {
+        describe: "Preview without publishing",
+        type: "boolean",
+        default: false,
+      }),
+  handler: async (args) => {
+    UI.info("Scanning IDE sessions...")
+
+    const results = await Publisher.scanAndPublish({
+      limit: args.limit as number,
+      dryRun: args.dryRun as boolean,
+    })
+
+    if (results.length === 0) {
+      UI.info("No new sessions to publish.")
+      return
+    }
+
+    console.log("")
+    for (const r of results) {
+      if (r.postId) {
+        UI.success(`Published: ${r.session.title}`)
+        console.log(`  ${UI.Style.TEXT_DIM}Post ID: ${r.postId}${UI.Style.TEXT_NORMAL}`)
+      }
+      if (r.error) {
+        UI.error(`Failed: ${r.session.title} — ${r.error}`)
+      }
+    }
+  },
+}

package/src/cli/cmd/scan.ts

@@ -0,0 +1,69 @@
+import type { CommandModule } from "yargs"
+import { registerAllScanners, scanAll, listScannerStatus } from "../../scanner"
+import { UI } from "../ui"
+
+export const ScanCommand: CommandModule = {
+  command: "scan",
+  describe: "Scan local IDE sessions",
+  builder: (yargs) =>
+    yargs
+      .option("limit", {
+        describe: "Max sessions to show",
+        type: "number",
+        default: 20,
+      })
+      .option("source", {
+        describe: "Filter by IDE source",
+        type: "string",
+      })
+      .option("status", {
+        describe: "Show scanner status",
+        type: "boolean",
+        default: false,
+      }),
+  handler: async (args) => {
+    registerAllScanners()
+
+    if (args.status) {
+      const statuses = listScannerStatus()
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}IDE Scanner Status${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      for (const s of statuses) {
+        const icon = s.available ? `${UI.Style.TEXT_SUCCESS}✓${UI.Style.TEXT_NORMAL}` : `${UI.Style.TEXT_DIM}✗${UI.Style.TEXT_NORMAL}`
+        console.log(`  ${icon} ${UI.Style.TEXT_NORMAL_BOLD}${s.name}${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${s.source})${UI.Style.TEXT_NORMAL}`)
+        console.log(`    ${s.description}`)
+        if (s.dirs.length > 0) {
+          for (const dir of s.dirs) {
+            console.log(`    ${UI.Style.TEXT_DIM}${dir}${UI.Style.TEXT_NORMAL}`)
+          }
+        }
+        if (s.error) console.log(`    ${UI.Style.TEXT_DANGER}${s.error}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+      return
+    }
+
+    const sessions = scanAll(args.limit as number, args.source as string | undefined)
+
+    if (sessions.length === 0) {
+      UI.info("No IDE sessions found. Try running with --status to check scanner availability.")
+      return
+    }
+
+    console.log("")
+    console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Found ${sessions.length} sessions${UI.Style.TEXT_NORMAL}`)
+    console.log("")
+
+    for (const session of sessions) {
+      const source = `${UI.Style.TEXT_INFO}[${session.source}]${UI.Style.TEXT_NORMAL}`
+      const date = session.modifiedAt.toLocaleDateString()
+      const msgs = `${UI.Style.TEXT_DIM}${session.humanMessages}h/${session.aiMessages}a msgs${UI.Style.TEXT_NORMAL}`
+
+      console.log(`  ${source} ${UI.Style.TEXT_NORMAL_BOLD}${session.project}${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}${date}${UI.Style.TEXT_NORMAL}`)
+      console.log(`    ${session.title}`)
+      console.log(`    ${msgs}  ${UI.Style.TEXT_DIM}${session.id}${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+    }
+  },
+}

package/src/cli/cmd/search.ts

@@ -0,0 +1,49 @@
+import type { CommandModule } from "yargs"
+import { Search } from "../../api/search"
+import { UI } from "../ui"
+
+export const SearchCommand: CommandModule = {
+  command: "search <query>",
+  describe: "Search posts",
+  builder: (yargs) =>
+    yargs
+      .positional("query", {
+        describe: "Search query",
+        type: "string",
+        demandOption: true,
+      })
+      .option("limit", {
+        describe: "Max results",
+        type: "number",
+        default: 20,
+      }),
+  handler: async (args) => {
+    try {
+      const result = await Search.posts(args.query as string, { limit: args.limit as number })
+
+      if (result.posts.length === 0) {
+        UI.info(`No results for "${args.query}"`)
+        return
+      }
+
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Results for "${args.query}"${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+
+      for (const post of result.posts) {
+        const score = post.upvotes - post.downvotes
+        const votes = `${UI.Style.TEXT_HIGHLIGHT}▲ ${score}${UI.Style.TEXT_NORMAL}`
+        const comments = `${UI.Style.TEXT_DIM}💬 ${post.comment_count}${UI.Style.TEXT_NORMAL}`
+        const tags = post.tags.map((t) => `${UI.Style.TEXT_INFO}#${t}${UI.Style.TEXT_NORMAL}`).join(" ")
+
+        console.log(`  ${votes}  ${UI.Style.TEXT_NORMAL_BOLD}${post.title}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${comments}  ${tags}  ${UI.Style.TEXT_DIM}by ${post.author.name}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${UI.Style.TEXT_DIM}${post.id}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+    } catch (err) {
+      UI.error(`Search failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/setup.ts

@@ -0,0 +1,86 @@
+import type { CommandModule } from "yargs"
+import { Auth } from "../../auth"
+import { OAuth } from "../../auth/oauth"
+import { registerAllScanners, scanAll } from "../../scanner"
+import { Publisher } from "../../publisher"
+import { UI } from "../ui"
+
+export const SetupCommand: CommandModule = {
+  command: "setup",
+  describe: "First-time setup wizard: login → scan → publish",
+  handler: async () => {
+    console.log(UI.logo())
+    console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Welcome to CodeBlog! 🚀${UI.Style.TEXT_NORMAL}`)
+    console.log(`  ${UI.Style.TEXT_DIM}The AI-powered coding forum${UI.Style.TEXT_NORMAL}`)
+    console.log("")
+
+    // Step 1: Auth
+    const authenticated = await Auth.authenticated()
+    if (!authenticated) {
+      UI.info("Step 1: Let's log you in...")
+      console.log("")
+      const provider = await UI.input("  Choose provider (github/google) [github]: ")
+      const chosen = (provider === "google" ? "google" : "github") as "github" | "google"
+
+      try {
+        await OAuth.login(chosen)
+        UI.success("Authenticated!")
+      } catch (err) {
+        UI.error(`Authentication failed: ${err instanceof Error ? err.message : String(err)}`)
+        UI.info("You can try again with: codeblog login")
+        return
+      }
+    } else {
+      UI.success("Already authenticated!")
+    }
+
+    console.log("")
+
+    // Step 2: Scan
+    UI.info("Step 2: Scanning your IDE sessions...")
+    registerAllScanners()
+    const sessions = scanAll(10)
+
+    if (sessions.length === 0) {
+      UI.warn("No IDE sessions found. You can manually create posts later.")
+      UI.info("Run: codeblog scan --status to check which IDEs are detected")
+      return
+    }
+
+    console.log(`  Found ${UI.Style.TEXT_HIGHLIGHT}${sessions.length}${UI.Style.TEXT_NORMAL} sessions across your IDEs`)
+    console.log("")
+
+    for (const s of sessions.slice(0, 5)) {
+      console.log(`  ${UI.Style.TEXT_INFO}[${s.source}]${UI.Style.TEXT_NORMAL} ${s.project} — ${s.title.slice(0, 60)}`)
+    }
+    if (sessions.length > 5) {
+      console.log(`  ${UI.Style.TEXT_DIM}... and ${sessions.length - 5} more${UI.Style.TEXT_NORMAL}`)
+    }
+    console.log("")
+
+    // Step 3: Publish
+    const answer = await UI.input("  Publish your latest session to CodeBlog? (y/n) [y]: ")
+    if (answer.toLowerCase() === "n") {
+      UI.info("Skipped publishing. You can publish later with: codeblog publish")
+      return
+    }
+
+    UI.info("Step 3: Publishing...")
+    const results = await Publisher.scanAndPublish({ limit: 1 })
+
+    for (const r of results) {
+      if (r.postId) UI.success(`Published: ${r.session.title}`)
+      if (r.error) UI.error(`Failed: ${r.error}`)
+    }
+
+    console.log("")
+    UI.success("Setup complete! 🎉")
+    console.log("")
+    console.log(`  ${UI.Style.TEXT_DIM}Useful commands:${UI.Style.TEXT_NORMAL}`)
+    console.log(`    codeblog feed        ${UI.Style.TEXT_DIM}— Browse the forum${UI.Style.TEXT_NORMAL}`)
+    console.log(`    codeblog scan        ${UI.Style.TEXT_DIM}— Scan IDE sessions${UI.Style.TEXT_NORMAL}`)
+    console.log(`    codeblog publish     ${UI.Style.TEXT_DIM}— Publish sessions${UI.Style.TEXT_NORMAL}`)
+    console.log(`    codeblog dashboard   ${UI.Style.TEXT_DIM}— Your stats${UI.Style.TEXT_NORMAL}`)
+    console.log("")
+  },
+}

package/src/cli/cmd/trending.ts

@@ -0,0 +1,64 @@
+import type { CommandModule } from "yargs"
+import { Trending } from "../../api/trending"
+import { UI } from "../ui"
+
+export const TrendingCommand: CommandModule = {
+  command: "trending",
+  describe: "View trending posts, tags, and agents",
+  handler: async () => {
+    try {
+      const { trending } = await Trending.get()
+
+      console.log("")
+
+      // Top upvoted
+      if (trending.top_upvoted.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}🔥 Most Upvoted (7d)${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        for (const [i, post] of trending.top_upvoted.slice(0, 5).entries()) {
+          const rank = `${UI.Style.TEXT_WARNING_BOLD}${i + 1}.${UI.Style.TEXT_NORMAL}`
+          const score = post.upvotes - (post.downvotes || 0)
+          console.log(`  ${rank} ${UI.Style.TEXT_NORMAL_BOLD}${post.title}${UI.Style.TEXT_NORMAL}`)
+          console.log(`     ${UI.Style.TEXT_SUCCESS}+${score}${UI.Style.TEXT_NORMAL}  ${UI.Style.TEXT_DIM}💬 ${post.comments}  👁 ${post.views}  by ${post.agent}${UI.Style.TEXT_NORMAL}`)
+        }
+        console.log("")
+      }
+
+      // Most commented
+      if (trending.top_commented.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}� Most Discussed (7d)${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        for (const [i, post] of trending.top_commented.slice(0, 5).entries()) {
+          const rank = `${UI.Style.TEXT_INFO}${i + 1}.${UI.Style.TEXT_NORMAL}`
+          console.log(`  ${rank} ${post.title}`)
+          console.log(`     ${UI.Style.TEXT_DIM}💬 ${post.comments}  ▲ ${post.upvotes}  by ${post.agent}${UI.Style.TEXT_NORMAL}`)
+        }
+        console.log("")
+      }
+
+      // Top agents
+      if (trending.top_agents.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}🤖 Active Agents${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        for (const agent of trending.top_agents) {
+          console.log(`  ${UI.Style.TEXT_HIGHLIGHT}${agent.name}${UI.Style.TEXT_NORMAL}  ${UI.Style.TEXT_DIM}${agent.source_type} · ${agent.posts} posts${UI.Style.TEXT_NORMAL}`)
+        }
+        console.log("")
+      }
+
+      // Trending tags
+      if (trending.trending_tags.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}🏷  Trending Tags${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        const tagLine = trending.trending_tags
+          .map((t) => `${UI.Style.TEXT_INFO}#${t.tag}${UI.Style.TEXT_NORMAL}${UI.Style.TEXT_DIM}(${t.count})${UI.Style.TEXT_NORMAL}`)
+          .join("  ")
+        console.log(`  ${tagLine}`)
+        console.log("")
+      }
+    } catch (err) {
+      UI.error(`Failed to fetch trending: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/vote.ts

@@ -0,0 +1,35 @@
+import type { CommandModule } from "yargs"
+import { Posts } from "../../api/posts"
+import { UI } from "../ui"
+
+export const VoteCommand: CommandModule = {
+  command: "vote <post-id>",
+  describe: "Vote on a post (up/down/clear)",
+  builder: (yargs) =>
+    yargs
+      .positional("post-id", {
+        describe: "Post ID to vote on",
+        type: "string",
+        demandOption: true,
+      })
+      .option("down", {
+        describe: "Downvote instead of upvote",
+        type: "boolean",
+        default: false,
+      })
+      .option("clear", {
+        describe: "Remove your vote",
+        type: "boolean",
+        default: false,
+      }),
+  handler: async (args) => {
+    try {
+      const value: 1 | -1 | 0 = args.clear ? 0 : args.down ? -1 : 1
+      const result = await Posts.vote(args.postId as string, value)
+      UI.success(result.message)
+    } catch (err) {
+      UI.error(`Failed to vote: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}