diff --git a/app/(pages)/admin/_components/Hackbot/HackbotUsageMetrics.tsx b/app/(pages)/admin/_components/Hackbot/HackbotUsageMetrics.tsx
new file mode 100644
index 000000000..3537aa3a6
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/HackbotUsageMetrics.tsx
@@ -0,0 +1,132 @@
+'use client';
+
+import { useState, useEffect, useCallback } from 'react';
+import {
+  getUsageMetrics,
+  type UsagePeriod,
+  type UsageMetrics,
+} from '@actions/hackbot/getUsageMetrics';
+
+const PERIODS: { value: UsagePeriod; label: string }[] = [
+  { value: '24h', label: 'Last 24 h' },
+  { value: '7d', label: 'Last 7 days' },
+  { value: '30d', label: 'Last 30 days' },
+];
+
+function fmt(n: number): string {
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(2)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}k`;
+  return String(n);
+}
+
+export default function HackbotUsageMetrics() {
+  const [period, setPeriod] = useState<UsagePeriod>('24h');
+  const [metrics, setMetrics] = useState<UsageMetrics | null>(null);
+  const [loading, setLoading] = useState(true);
+
+  const load = useCallback(async (p: UsagePeriod) => {
+    setLoading(true);
+    try {
+      setMetrics(await getUsageMetrics(p));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    void load(period);
+  }, [period, load]);
+
+  const uncachedTokens = metrics
+    ? metrics.totalPromptTokens - metrics.totalCachedTokens
+    : 0;
+  const hitPct = metrics ? Math.round(metrics.cacheHitRate * 100) : 0;
+
+  return (
+    <section className="border border-gray-200 rounded-lg overflow-hidden">
+      {/* Header */}
+      <div className="flex items-center justify-between px-5 py-3 bg-gray-50 border-b border-gray-200">
+        <h2 className="text-sm font-semibold text-gray-700">Usage Metrics</h2>
+        <div className="flex gap-1">
+          {PERIODS.map(({ value, label }) => (
+            <button
+              key={value}
+              type="button"
+              onClick={() => setPeriod(value)}
+              className={`px-3 py-1 rounded-md text-xs font-medium transition-colors ${
+                period === value
+                  ? 'bg-[#005271] text-white'
+                  : 'text-gray-500 hover:bg-gray-100'
+              }`}
+            >
+              {label}
+            </button>
+          ))}
+        </div>
+      </div>
+
+      {/* Metric cards */}
+      <div
+        className={`grid grid-cols-2 md:grid-cols-4 divide-x divide-y md:divide-y-0 divide-gray-200 transition-opacity ${
+          loading ? 'opacity-40' : 'opacity-100'
+        }`}
+      >
+        {/* Requests */}
+        <div className="px-5 py-4">
+          <p className="text-xs text-gray-500 mb-1">Requests</p>
+          <p className="text-2xl font-bold text-gray-800">
+            {metrics ? fmt(metrics.totalRequests) : '—'}
+          </p>
+        </div>
+
+        {/* Cache hit rate */}
+        <div className="px-5 py-4">
+          <p className="text-xs text-gray-500 mb-1">Cache hit rate</p>
+          <p className="text-2xl font-bold text-[#005271]">
+            {metrics ? `${hitPct}%` : '—'}
+          </p>
+          {metrics && metrics.totalPromptTokens > 0 && (
+            <div className="mt-2 h-1.5 rounded-full bg-gray-200 overflow-hidden">
+              <div
+                className="h-full rounded-full bg-[#005271] transition-all"
+                style={{ width: `${hitPct}%` }}
+              />
+            </div>
+          )}
+        </div>
+
+        {/* Prompt tokens breakdown */}
+        <div className="px-5 py-4">
+          <p className="text-xs text-gray-500 mb-1">Prompt tokens</p>
+          {metrics ? (
+            <>
+              <p className="text-2xl font-bold text-gray-800">
+                {fmt(metrics.totalPromptTokens)}
+              </p>
+              <div className="mt-1.5 flex flex-col gap-0.5 text-xs text-gray-500">
+                <span className="flex items-center gap-1">
+                  <span className="inline-block w-2 h-2 rounded-sm bg-[#9EE7E5]" />
+                  {fmt(metrics.totalCachedTokens)} cached
+                </span>
+                <span className="flex items-center gap-1">
+                  <span className="inline-block w-2 h-2 rounded-sm bg-gray-300" />
+                  {fmt(uncachedTokens)} uncached
+                </span>
+              </div>
+            </>
+          ) : (
+            <p className="text-2xl font-bold text-gray-800">—</p>
+          )}
+        </div>
+
+        {/* Completion tokens */}
+        <div className="px-5 py-4">
+          <p className="text-xs text-gray-500 mb-1">Completion tokens</p>
+          <p className="text-2xl font-bold text-gray-800">
+            {metrics ? fmt(metrics.totalCompletionTokens) : '—'}
+          </p>
+        </div>
+      </div>
+    </section>
+  );
+}
diff --git a/app/(pages)/admin/_components/Hackbot/KnowledgeBanners.tsx b/app/(pages)/admin/_components/Hackbot/KnowledgeBanners.tsx
new file mode 100644
index 000000000..d0cdbaa38
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/KnowledgeBanners.tsx
@@ -0,0 +1,111 @@
+'use client';
+
+import useHackbotKnowledge from '../../_hooks/useHackbotKnowledge';
+
+export default function KnowledgeBanners() {
+  const {
+    banner,
+    setBanner,
+    reseedResult,
+    setReseedResult,
+    clearResult,
+    setClearResult,
+    importResult,
+    setImportResult,
+    importError,
+  } = useHackbotKnowledge();
+
+  return (
+    <>
+      {/* Global banner */}
+      {banner && (
+        <div
+          className={`flex items-center justify-between rounded-lg px-4 py-3 text-sm border ${
+            banner.kind === 'success'
+              ? 'bg-green-50 border-green-200 text-green-700'
+              : 'bg-red-50 border-red-200 text-red-700'
+          }`}
+        >
+          <span>{banner.message}</span>
+          <button
+            onClick={() => setBanner(null)}
+            className="text-xs underline opacity-70 hover:opacity-100 ml-4"
+          >
+            Dismiss
+          </button>
+        </div>
+      )}
+
+      {/* Reseed result */}
+      {reseedResult && (
+        <div
+          className={`flex items-center justify-between rounded-lg px-4 py-3 text-sm border ${
+            reseedResult.ok
+              ? 'bg-green-50 border-green-200 text-green-700'
+              : 'bg-red-50 border-red-200 text-red-700'
+          }`}
+        >
+          <span>
+            {reseedResult.ok
+              ? `Reseeded ${reseedResult.successCount} doc${
+                  reseedResult.successCount !== 1 ? 's' : ''
+                } successfully.`
+              : reseedResult.error ??
+                `${reseedResult.failureCount} doc(s) failed to reseed.`}
+          </span>
+          <button
+            onClick={() => setReseedResult(null)}
+            className="text-xs underline opacity-70 hover:opacity-100 ml-4"
+          >
+            Dismiss
+          </button>
+        </div>
+      )}
+
+      {/* Clear result — error only (success goes via banner) */}
+      {clearResult && !clearResult.ok && (
+        <div className="flex items-center justify-between bg-red-50 border border-red-200 rounded-lg px-4 py-3 text-sm text-red-700">
+          <span>Failed to clear: {clearResult.error}</span>
+          <button
+            onClick={() => setClearResult(null)}
+            className="text-xs underline opacity-70 hover:opacity-100 ml-4"
+          >
+            Dismiss
+          </button>
+        </div>
+      )}
+
+      {/* Import result — error only (success goes via banner) */}
+      {importResult && !importResult.ok && (
+        <div className="flex flex-col gap-1 bg-red-50 border border-red-200 rounded-lg px-4 py-3 text-sm text-red-700">
+          <div className="flex items-center justify-between">
+            <span>
+              {importResult.successCount} imported, {importResult.failureCount}{' '}
+              failed.
+            </span>
+            <button
+              onClick={() => setImportResult(null)}
+              className="text-xs underline opacity-70 hover:opacity-100 ml-4"
+            >
+              Dismiss
+            </button>
+          </div>
+          {importResult.failures.length > 0 && (
+            <ul className="mt-1 text-xs list-disc list-inside space-y-0.5">
+              {importResult.failures.map((f, i) => (
+                <li key={i}>{f}</li>
+              ))}
+            </ul>
+          )}
+        </div>
+      )}
+
+      {/* Import parse error */}
+      {importError && (
+        <p className="text-sm text-red-600 bg-red-50 border border-red-200 rounded-md px-3 py-2">
+          {importError}
+        </p>
+      )}
+    </>
+  );
+}
diff --git a/app/(pages)/admin/_components/Hackbot/KnowledgeDocModal.tsx b/app/(pages)/admin/_components/Hackbot/KnowledgeDocModal.tsx
new file mode 100644
index 000000000..3c378a638
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/KnowledgeDocModal.tsx
@@ -0,0 +1,133 @@
+'use client';
+
+import { RxCross1 } from 'react-icons/rx';
+import useHackbotKnowledge from '../../_hooks/useHackbotKnowledge';
+import { DOC_TYPES, TYPE_LABELS } from '../../_constants/hackbotKnowledge';
+import type { HackDocType } from '@typeDefs/hackbot';
+
+export default function KnowledgeDocModal() {
+  const {
+    modalOpen,
+    editingDoc,
+    form,
+    setForm,
+    formError,
+    isSaving,
+    closeModal,
+    handleSave,
+  } = useHackbotKnowledge();
+
+  if (!modalOpen) return null;
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/40 p-4">
+      <div className="bg-white rounded-xl shadow-xl w-full max-w-2xl flex flex-col gap-5 p-6 max-h-[90vh] overflow-y-auto">
+        <div className="flex items-center justify-between">
+          <h2 className="text-xl font-bold">
+            {editingDoc ? 'Edit Document' : 'Add Document'}
+          </h2>
+          <button
+            onClick={closeModal}
+            className="text-gray-400 hover:text-gray-600 transition-colors"
+            aria-label="Close modal"
+          >
+            <RxCross1 className="w-4 h-4" />
+          </button>
+        </div>
+
+        <div className="flex flex-col gap-4">
+          {/* Type */}
+          <div className="flex flex-col gap-1">
+            <label className="text-sm font-medium text-gray-700">Type</label>
+            <select
+              value={form.type}
+              onChange={(e) =>
+                setForm((f) => ({ ...f, type: e.target.value as HackDocType }))
+              }
+              className="border border-gray-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-[#005271]"
+            >
+              {DOC_TYPES.map((t) => (
+                <option key={t} value={t}>
+                  {TYPE_LABELS[t]}
+                </option>
+              ))}
+            </select>
+          </div>
+
+          {/* Title */}
+          <div className="flex flex-col gap-1">
+            <label className="text-sm font-medium text-gray-700">Title</label>
+            <input
+              type="text"
+              value={form.title}
+              onChange={(e) =>
+                setForm((f) => ({ ...f, title: e.target.value }))
+              }
+              placeholder="e.g. Judging Process Overview"
+              className="border border-gray-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-[#005271]"
+            />
+          </div>
+
+          {/* URL */}
+          <div className="flex flex-col gap-1">
+            <label className="text-sm font-medium text-gray-700">
+              URL <span className="text-gray-400 font-normal">(optional)</span>
+            </label>
+            <input
+              type="text"
+              value={form.url ?? ''}
+              onChange={(e) =>
+                setForm((f) => ({ ...f, url: e.target.value || null }))
+              }
+              placeholder="e.g. /project-info#judging"
+              className="border border-gray-300 rounded-lg px-3 py-2 text-sm font-mono focus:outline-none focus:ring-2 focus:ring-[#005271]"
+            />
+          </div>
+
+          {/* Content */}
+          <div className="flex flex-col gap-1">
+            <label className="text-sm font-medium text-gray-700">Content</label>
+            <textarea
+              value={form.content}
+              onChange={(e) =>
+                setForm((f) => ({ ...f, content: e.target.value }))
+              }
+              placeholder="Write the knowledge content here. This text is used for both display and semantic search."
+              rows={8}
+              className="border border-gray-300 rounded-lg px-3 py-2 text-sm resize-y focus:outline-none focus:ring-2 focus:ring-[#005271]"
+            />
+          </div>
+
+          {formError && (
+            <p className="text-sm text-red-600 bg-red-50 border border-red-200 rounded-md px-3 py-2">
+              {formError}
+            </p>
+          )}
+        </div>
+
+        <div className="flex items-center justify-end gap-3 pt-1">
+          <button
+            onClick={closeModal}
+            className="text-sm text-gray-500 hover:text-gray-700 px-4 py-2"
+          >
+            Cancel
+          </button>
+          <button
+            onClick={handleSave}
+            disabled={isSaving}
+            className="bg-[#005271] text-white font-semibold px-6 py-2.5 rounded-lg hover:bg-[#003d54] disabled:opacity-50 disabled:cursor-not-allowed transition-colors text-sm"
+          >
+            {isSaving ? (
+              <span className="flex items-center gap-2">
+                <span className="w-4 h-4 border-2 border-white border-t-transparent rounded-full animate-spin" />
+                Saving…
+              </span>
+            ) : (
+              'Save & Embed'
+            )}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/app/(pages)/admin/_components/Hackbot/KnowledgeImportPreview.tsx b/app/(pages)/admin/_components/Hackbot/KnowledgeImportPreview.tsx
new file mode 100644
index 000000000..e3512ffd4
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/KnowledgeImportPreview.tsx
@@ -0,0 +1,88 @@
+'use client';
+
+import useHackbotKnowledge from '../../_hooks/useHackbotKnowledge';
+import { TYPE_LABELS, TYPE_COLORS } from '../../_constants/hackbotKnowledge';
+import type { HackDocType } from '@typeDefs/hackbot';
+
+export default function KnowledgeImportPreview() {
+  const { importPreview, isImporting, handleImport, cancelImport } =
+    useHackbotKnowledge();
+
+  return (
+    <>
+      {/* Import preview */}
+      {importPreview && (
+        <div className="border border-blue-200 rounded-xl bg-blue-50 p-4 flex flex-col gap-3">
+          <div className="flex items-center justify-between">
+            <p className="text-sm font-semibold text-blue-800">
+              Import preview — {importPreview.length} document
+              {importPreview.length !== 1 ? 's' : ''}
+            </p>
+            <div className="flex items-center gap-2">
+              <button
+                onClick={cancelImport}
+                className="text-xs text-blue-600 underline"
+              >
+                Cancel
+              </button>
+              <button
+                onClick={handleImport}
+                disabled={isImporting}
+                className="bg-[#005271] text-white text-xs font-semibold px-4 py-1.5 rounded-lg hover:bg-[#003d54] disabled:opacity-50 transition-colors"
+              >
+                {isImporting ? (
+                  <span className="flex items-center gap-1.5">
+                    <span className="w-3 h-3 border-2 border-white border-t-transparent rounded-full animate-spin" />
+                    Importing…
+                  </span>
+                ) : (
+                  'Confirm Import'
+                )}
+              </button>
+            </div>
+          </div>
+          <div className="max-h-48 overflow-y-auto flex flex-col gap-1">
+            {importPreview.map((doc, i) => (
+              <div
+                key={i}
+                className="bg-white border border-blue-100 rounded-lg px-3 py-2 text-xs flex items-start gap-2"
+              >
+                <span
+                  className={`inline-flex items-center px-1.5 py-0.5 rounded text-[10px] font-medium border shrink-0 ${
+                    TYPE_COLORS[doc.type] ?? TYPE_COLORS.general
+                  }`}
+                >
+                  {TYPE_LABELS[doc.type as HackDocType] ?? doc.type}
+                </span>
+                <div className="min-w-0">
+                  <p className="font-medium text-gray-800 truncate">
+                    {doc.title}
+                  </p>
+                  <p className="text-gray-400 truncate">
+                    {doc.content.slice(0, 80)}
+                    {doc.content.length > 80 ? '…' : ''}
+                  </p>
+                </div>
+              </div>
+            ))}
+          </div>
+        </div>
+      )}
+
+      {/* JSON format hint */}
+      <details className="text-xs text-gray-400">
+        <summary className="cursor-pointer hover:text-gray-600 select-none">
+          JSON import format
+        </summary>
+        <pre className="mt-2 bg-gray-50 border border-gray-200 rounded-lg p-3 text-gray-600 overflow-x-auto">{`[
+  {
+    "type": "general",        // judging | submission | faq | general | track | event
+    "title": "Doc title",
+    "content": "Full text content used for both display and semantic search.",
+    "url": "/hackers/hub/..."  // optional
+  }
+]`}</pre>
+      </details>
+    </>
+  );
+}
diff --git a/app/(pages)/admin/_components/Hackbot/KnowledgeLoadState.tsx b/app/(pages)/admin/_components/Hackbot/KnowledgeLoadState.tsx
new file mode 100644
index 000000000..a4471c154
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/KnowledgeLoadState.tsx
@@ -0,0 +1,33 @@
+'use client';
+
+import { ReactNode } from 'react';
+import useHackbotKnowledge from '../../_hooks/useHackbotKnowledge';
+
+export default function KnowledgeLoadState({
+  children,
+}: {
+  children: ReactNode;
+}) {
+  const { loading, loadError } = useHackbotKnowledge();
+
+  if (loading) {
+    return (
+      <div className="p-8 flex items-center gap-2 text-sm text-gray-500">
+        <div className="w-4 h-4 border-2 border-[#005271] border-t-transparent rounded-full animate-spin" />
+        Loading knowledge docs…
+      </div>
+    );
+  }
+
+  if (loadError) {
+    return (
+      <div className="p-8">
+        <p className="text-sm text-red-600 bg-red-50 border border-red-200 rounded-md px-3 py-2">
+          {loadError}
+        </p>
+      </div>
+    );
+  }
+
+  return <>{children}</>;
+}
diff --git a/app/(pages)/admin/_components/Hackbot/KnowledgeTable.tsx b/app/(pages)/admin/_components/Hackbot/KnowledgeTable.tsx
new file mode 100644
index 000000000..c9ad32ec2
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/KnowledgeTable.tsx
@@ -0,0 +1,86 @@
+'use client';
+
+import useHackbotKnowledge from '../../_hooks/useHackbotKnowledge';
+import { TYPE_LABELS, TYPE_COLORS } from '../../_constants/hackbotKnowledge';
+
+export default function KnowledgeTable() {
+  const { docs, isDeleting, deletingId, openEdit, handleDelete } =
+    useHackbotKnowledge();
+
+  if (docs.length === 0) {
+    return (
+      <div className="border border-dashed border-gray-300 rounded-lg p-8 text-center text-gray-400 text-sm">
+        No knowledge documents yet. Click{' '}
+        <span className="font-medium text-gray-600">+ Add Doc</span> to create
+        one, or <span className="font-medium text-gray-600">Import JSON</span>{' '}
+        to bulk-import.
+      </div>
+    );
+  }
+
+  return (
+    <div className="border border-gray-200 rounded-lg overflow-hidden w-full">
+      <table className="w-full text-sm">
+        <thead>
+          <tr className="bg-gray-50 border-b border-gray-200 text-left text-xs font-semibold text-gray-500 uppercase tracking-wide">
+            <th className="px-4 py-3">Type</th>
+            <th className="px-4 py-3">Title</th>
+            <th className="px-4 py-3 w-64">URL</th>
+            <th className="px-4 py-3 hidden md:table-cell">Content preview</th>
+            <th className="px-4 py-3 w-28 text-right">Actions</th>
+          </tr>
+        </thead>
+        <tbody className="divide-y divide-gray-100">
+          {docs.map((doc) => (
+            <tr key={doc.id} className="hover:bg-gray-50 transition-colors">
+              <td className="px-4 py-3">
+                <span
+                  className={`inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium border ${
+                    TYPE_COLORS[doc.type] ?? TYPE_COLORS.general
+                  }`}
+                >
+                  {TYPE_LABELS[doc.type] ?? doc.type}
+                </span>
+              </td>
+              <td className="px-4 py-3 font-medium text-gray-900">
+                {doc.title}
+              </td>
+              <td className="px-4 py-3 text-gray-500 truncate max-w-[180px]">
+                {doc.url ? (
+                  <span className="font-mono text-xs">{doc.url}</span>
+                ) : (
+                  <span className="text-gray-300">—</span>
+                )}
+              </td>
+              <td className="px-4 py-3 text-gray-400 text-xs hidden md:table-cell">
+                <span className="line-clamp-2">{doc.content}</span>
+              </td>
+              <td className="px-4 py-3 text-right">
+                <div className="flex items-center justify-end gap-2">
+                  <button
+                    onClick={() => openEdit(doc)}
+                    className="text-[#005271] hover:underline text-xs font-medium"
+                  >
+                    Edit
+                  </button>
+                  <button
+                    onClick={() => handleDelete(doc.id)}
+                    disabled={isDeleting && deletingId === doc.id}
+                    className="text-red-500 hover:underline text-xs font-medium disabled:opacity-50"
+                  >
+                    {isDeleting && deletingId === doc.id
+                      ? 'Deleting…'
+                      : 'Delete'}
+                  </button>
+                </div>
+              </td>
+            </tr>
+          ))}
+        </tbody>
+      </table>
+      <div className="px-4 py-2 bg-gray-50 border-t border-gray-200 text-xs text-gray-400">
+        {docs.length} document{docs.length !== 1 ? 's' : ''} total
+      </div>
+    </div>
+  );
+}
diff --git a/app/(pages)/admin/_components/Hackbot/KnowledgeToolbar.tsx b/app/(pages)/admin/_components/Hackbot/KnowledgeToolbar.tsx
new file mode 100644
index 000000000..0f301219b
--- /dev/null
+++ b/app/(pages)/admin/_components/Hackbot/KnowledgeToolbar.tsx
@@ -0,0 +1,128 @@
+'use client';
+
+import { useRef } from 'react';
+import { ImportDocInput } from '@actions/hackbot/importKnowledgeDocs';
+import useHackbotKnowledge from '../../_hooks/useHackbotKnowledge';
+
+export default function KnowledgeToolbar() {
+  const {
+    docs,
+    isImporting,
+    isClearing,
+    isReseeding,
+    setImportPreview,
+    setImportError,
+    setImportResult,
+    handleClearAll,
+    handleReseed,
+    openCreate,
+  } = useHackbotKnowledge();
+
+  const fileInputRef = useRef<HTMLInputElement>(null);
+
+  function handleFileChange(e: React.ChangeEvent<HTMLInputElement>) {
+    const file = e.target.files?.[0];
+    if (!file) return;
+
+    setImportError('');
+    setImportPreview(null);
+    setImportResult(null);
+
+    const reader = new FileReader();
+    reader.onload = (ev) => {
+      try {
+        const parsed = JSON.parse(ev.target?.result as string);
+        if (!Array.isArray(parsed)) {
+          setImportError('JSON must be an array of documents.');
+          return;
+        }
+        for (let i = 0; i < parsed.length; i++) {
+          const d = parsed[i];
+          if (!d.title || !d.content) {
+            setImportError(
+              `Item ${i + 1} is missing required fields "title" or "content".`
+            );
+            return;
+          }
+          if (!d.type) {
+            setImportError(`Item ${i + 1} is missing "type" field.`);
+            return;
+          }
+        }
+        setImportPreview(parsed as ImportDocInput[]);
+      } catch {
+        setImportError('Invalid JSON file. Please check the format.');
+      }
+    };
+    reader.readAsText(file);
+    e.target.value = '';
+  }
+
+  return (
+    <div className="flex items-start justify-between gap-4">
+      <div className="flex flex-col gap-1">
+        <h1 className="text-3xl font-bold">HackBot Knowledge</h1>
+        <p className="text-sm text-gray-500">
+          Manage the knowledge base for HackDavis Helper. Each doc is embedded
+          into the vector index immediately on save. Events are served live from
+          the database via tool calls — no reseeding needed for schedule
+          changes.
+        </p>
+      </div>
+
+      <div className="flex items-center gap-2 shrink-0 flex-wrap justify-end">
+        <input
+          ref={fileInputRef}
+          type="file"
+          accept=".json"
+          className="hidden"
+          onChange={handleFileChange}
+        />
+        <button
+          onClick={() => fileInputRef.current?.click()}
+          disabled={isImporting}
+          className="border border-gray-300 text-gray-700 font-semibold px-4 py-2 rounded-lg hover:bg-gray-50 disabled:opacity-50 disabled:cursor-not-allowed transition-colors text-sm"
+        >
+          Import JSON
+        </button>
+
+        <button
+          onClick={handleClearAll}
+          disabled={isClearing || docs.length === 0}
+          className="border border-red-300 text-red-600 font-semibold px-4 py-2 rounded-lg hover:bg-red-50 disabled:opacity-50 disabled:cursor-not-allowed transition-colors text-sm"
+        >
+          {isClearing ? (
+            <span className="flex items-center gap-2">
+              <span className="w-3.5 h-3.5 border-2 border-red-400 border-t-transparent rounded-full animate-spin" />
+              Clearing…
+            </span>
+          ) : (
+            'Clear All'
+          )}
+        </button>
+
+        <button
+          onClick={handleReseed}
+          disabled={isReseeding || docs.length === 0}
+          className="border border-[#005271] text-[#005271] font-semibold px-4 py-2 rounded-lg hover:bg-[#005271]/5 disabled:opacity-50 disabled:cursor-not-allowed transition-colors text-sm"
+        >
+          {isReseeding ? (
+            <span className="flex items-center gap-2">
+              <span className="w-3.5 h-3.5 border-2 border-[#005271] border-t-transparent rounded-full animate-spin" />
+              Reseeding…
+            </span>
+          ) : (
+            'Reseed All'
+          )}
+        </button>
+
+        <button
+          onClick={openCreate}
+          className="bg-[#005271] text-white font-semibold px-4 py-2 rounded-lg hover:bg-[#003d54] transition-colors text-sm"
+        >
+          + Add Doc
+        </button>
+      </div>
+    </div>
+  );
+}
diff --git a/app/(pages)/admin/_constants/hackbotKnowledge.ts b/app/(pages)/admin/_constants/hackbotKnowledge.ts
new file mode 100644
index 000000000..cf160a256
--- /dev/null
+++ b/app/(pages)/admin/_constants/hackbotKnowledge.ts
@@ -0,0 +1,35 @@
+import type { HackDocType } from '@typeDefs/hackbot';
+import type { SaveKnowledgeDocInput } from '@actions/hackbot/saveKnowledgeDoc';
+
+export const DOC_TYPES: HackDocType[] = [
+  'judging',
+  'submission',
+  'faq',
+  'general',
+  'track',
+];
+
+export const TYPE_LABELS: Record<HackDocType, string> = {
+  judging: 'Judging',
+  submission: 'Submission',
+  faq: 'FAQ',
+  general: 'General',
+  track: 'Track',
+  event: 'Event',
+};
+
+export const TYPE_COLORS: Record<string, string> = {
+  judging: 'bg-purple-50 text-purple-700 border-purple-200',
+  submission: 'bg-blue-50 text-blue-700 border-blue-200',
+  faq: 'bg-yellow-50 text-yellow-700 border-yellow-200',
+  general: 'bg-gray-50 text-gray-700 border-gray-200',
+  track: 'bg-green-50 text-green-700 border-green-200',
+  event: 'bg-orange-50 text-orange-700 border-orange-200',
+};
+
+export const EMPTY_FORM: SaveKnowledgeDocInput = {
+  type: 'general',
+  title: '',
+  content: '',
+  url: null,
+};
diff --git a/app/(pages)/admin/_contexts/HackbotKnowledgeContext.tsx b/app/(pages)/admin/_contexts/HackbotKnowledgeContext.tsx
new file mode 100644
index 000000000..6b4446950
--- /dev/null
+++ b/app/(pages)/admin/_contexts/HackbotKnowledgeContext.tsx
@@ -0,0 +1,306 @@
+'use client';
+
+import {
+  createContext,
+  useEffect,
+  useState,
+  useTransition,
+  ReactNode,
+} from 'react';
+import getKnowledgeDocs, {
+  KnowledgeDoc,
+} from '@actions/hackbot/getKnowledgeDocs';
+import saveKnowledgeDoc, {
+  SaveKnowledgeDocInput,
+} from '@actions/hackbot/saveKnowledgeDoc';
+import deleteKnowledgeDoc from '@actions/hackbot/deleteKnowledgeDoc';
+import reseedHackbot, { ReseedResult } from '@actions/hackbot/reseedHackbot';
+import importKnowledgeDocs, {
+  ImportDocInput,
+  ImportKnowledgeDocsResult,
+} from '@actions/hackbot/importKnowledgeDocs';
+import clearKnowledgeDocs, {
+  ClearKnowledgeDocsResult,
+} from '@actions/hackbot/clearKnowledgeDocs';
+import { EMPTY_FORM } from '../_constants/hackbotKnowledge';
+
+// ── Types ────────────────────────────────────────────────────────────────────
+
+export type BannerState = {
+  kind: 'success' | 'error';
+  message: string;
+} | null;
+
+export type HackbotKnowledgeContextValue = {
+  // Docs
+  docs: KnowledgeDoc[];
+  loading: boolean;
+  loadError: string;
+
+  // Banner
+  banner: BannerState;
+  setBanner: (b: BannerState) => void;
+
+  // Modal
+  modalOpen: boolean;
+  editingDoc: KnowledgeDoc | null;
+  form: SaveKnowledgeDocInput;
+  setForm: React.Dispatch<React.SetStateAction<SaveKnowledgeDocInput>>;
+  formError: string;
+  isSaving: boolean;
+  openCreate: () => void;
+  openEdit: (doc: KnowledgeDoc) => void;
+  closeModal: () => void;
+  handleSave: () => void;
+
+  // Delete
+  deletingId: string | null;
+  isDeleting: boolean;
+  handleDelete: (id: string) => void;
+
+  // Reseed
+  reseedResult: ReseedResult | null;
+  setReseedResult: (r: ReseedResult | null) => void;
+  isReseeding: boolean;
+  handleReseed: () => void;
+
+  // Import
+  importResult: ImportKnowledgeDocsResult | null;
+  setImportResult: (r: ImportKnowledgeDocsResult | null) => void;
+  isImporting: boolean;
+  importPreview: ImportDocInput[] | null;
+  setImportPreview: (p: ImportDocInput[] | null) => void;
+  importError: string;
+  setImportError: (e: string) => void;
+  handleImport: () => void;
+  cancelImport: () => void;
+
+  // Clear
+  clearResult: ClearKnowledgeDocsResult | null;
+  setClearResult: (r: ClearKnowledgeDocsResult | null) => void;
+  isClearing: boolean;
+  handleClearAll: () => void;
+};
+
+// ── Context ──────────────────────────────────────────────────────────────────
+
+export const HackbotKnowledgeContext =
+  createContext<HackbotKnowledgeContextValue | null>(null);
+
+// ── Provider ─────────────────────────────────────────────────────────────────
+
+export default function HackbotKnowledgeProvider({
+  children,
+}: {
+  children: ReactNode;
+}) {
+  const [docs, setDocs] = useState<KnowledgeDoc[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [loadError, setLoadError] = useState('');
+  const [banner, setBanner] = useState<BannerState>(null);
+
+  // Modal
+  const [modalOpen, setModalOpen] = useState(false);
+  const [editingDoc, setEditingDoc] = useState<KnowledgeDoc | null>(null);
+  const [form, setForm] = useState<SaveKnowledgeDocInput>(EMPTY_FORM);
+  const [formError, setFormError] = useState('');
+  const [isSaving, startSaving] = useTransition();
+
+  // Delete
+  const [deletingId, setDeletingId] = useState<string | null>(null);
+  const [isDeleting, startDeleting] = useTransition();
+
+  // Reseed
+  const [reseedResult, setReseedResult] = useState<ReseedResult | null>(null);
+  const [isReseeding, startReseeding] = useTransition();
+
+  // Import
+  const [importResult, setImportResult] =
+    useState<ImportKnowledgeDocsResult | null>(null);
+  const [isImporting, startImporting] = useTransition();
+  const [importPreview, setImportPreview] = useState<ImportDocInput[] | null>(
+    null
+  );
+  const [importError, setImportError] = useState('');
+
+  // Clear
+  const [clearResult, setClearResult] =
+    useState<ClearKnowledgeDocsResult | null>(null);
+  const [isClearing, startClearing] = useTransition();
+
+  async function loadDocs() {
+    setLoading(true);
+    const res = await getKnowledgeDocs();
+    if (res.ok) {
+      setDocs(res.docs);
+    } else {
+      setLoadError(res.error ?? 'Failed to load docs');
+    }
+    setLoading(false);
+  }
+
+  useEffect(() => {
+    loadDocs();
+  }, []);
+
+  function openCreate() {
+    setEditingDoc(null);
+    setForm(EMPTY_FORM);
+    setFormError('');
+    setModalOpen(true);
+  }
+
+  function openEdit(doc: KnowledgeDoc) {
+    setEditingDoc(doc);
+    setForm({
+      id: doc.id,
+      type: doc.type,
+      title: doc.title,
+      content: doc.content,
+      url: doc.url,
+    });
+    setFormError('');
+    setModalOpen(true);
+  }
+
+  function closeModal() {
+    setModalOpen(false);
+    setFormError('');
+  }
+
+  function handleSave() {
+    if (!form.title.trim() || !form.content.trim()) {
+      setFormError('Title and content are required.');
+      return;
+    }
+    startSaving(async () => {
+      const res = await saveKnowledgeDoc(form);
+      if (res.ok) {
+        closeModal();
+        await loadDocs();
+        setBanner({
+          kind: 'success',
+          message: editingDoc
+            ? 'Document updated.'
+            : 'Document created and embedded.',
+        });
+      } else {
+        setFormError(res.error ?? 'Failed to save');
+      }
+    });
+  }
+
+  function handleDelete(id: string) {
+    if (!confirm('Delete this document? This cannot be undone.')) return;
+    setDeletingId(id);
+    startDeleting(async () => {
+      await deleteKnowledgeDoc(id);
+      setDeletingId(null);
+      await loadDocs();
+      setBanner({ kind: 'success', message: 'Document deleted.' });
+    });
+  }
+
+  function handleReseed() {
+    setReseedResult(null);
+    setBanner(null);
+    startReseeding(async () => {
+      const res = await reseedHackbot();
+      setReseedResult(res);
+    });
+  }
+
+  function handleImport() {
+    if (!importPreview) return;
+    startImporting(async () => {
+      const res = await importKnowledgeDocs(importPreview);
+      setImportResult(res);
+      setImportPreview(null);
+      if (res.ok) {
+        await loadDocs();
+        setBanner({
+          kind: 'success',
+          message: `Imported ${res.successCount} doc${
+            res.successCount !== 1 ? 's' : ''
+          } successfully.`,
+        });
+      }
+    });
+  }
+
+  function cancelImport() {
+    setImportPreview(null);
+    setImportError('');
+  }
+
+  function handleClearAll() {
+    if (
+      !confirm(
+        'Delete ALL knowledge docs? This removes everything from hackbot_knowledge and hackbot_docs. This cannot be undone.'
+      )
+    )
+      return;
+    setClearResult(null);
+    setBanner(null);
+    startClearing(async () => {
+      const res = await clearKnowledgeDocs();
+      setClearResult(res);
+      if (res.ok) {
+        await loadDocs();
+        setBanner({
+          kind: 'success',
+          message: `Cleared ${res.deletedKnowledge} knowledge doc${
+            res.deletedKnowledge !== 1 ? 's' : ''
+          } and ${res.deletedEmbeddings} embedding${
+            res.deletedEmbeddings !== 1 ? 's' : ''
+          }.`,
+        });
+        setClearResult(null);
+      }
+    });
+  }
+
+  const value: HackbotKnowledgeContextValue = {
+    docs,
+    loading,
+    loadError,
+    banner,
+    setBanner,
+    modalOpen,
+    editingDoc,
+    form,
+    setForm,
+    formError,
+    isSaving,
+    openCreate,
+    openEdit,
+    closeModal,
+    handleSave,
+    deletingId,
+    isDeleting,
+    handleDelete,
+    reseedResult,
+    setReseedResult,
+    isReseeding,
+    handleReseed,
+    importResult,
+    setImportResult,
+    isImporting,
+    importPreview,
+    setImportPreview,
+    importError,
+    setImportError,
+    handleImport,
+    cancelImport,
+    clearResult,
+    setClearResult,
+    isClearing,
+    handleClearAll,
+  };
+
+  return (
+    <HackbotKnowledgeContext.Provider value={value}>
+      {children}
+    </HackbotKnowledgeContext.Provider>
+  );
+}
diff --git a/app/(pages)/admin/_hooks/useHackbotKnowledge.tsx b/app/(pages)/admin/_hooks/useHackbotKnowledge.tsx
new file mode 100644
index 000000000..357869141
--- /dev/null
+++ b/app/(pages)/admin/_hooks/useHackbotKnowledge.tsx
@@ -0,0 +1,12 @@
+import { useContext } from 'react';
+import { HackbotKnowledgeContext } from '../_contexts/HackbotKnowledgeContext';
+
+export default function useHackbotKnowledge() {
+  const context = useContext(HackbotKnowledgeContext);
+  if (!context) {
+    throw new Error(
+      'useHackbotKnowledge must be used within a HackbotKnowledgeProvider'
+    );
+  }
+  return context;
+}
diff --git a/app/(pages)/admin/hackbot/page.tsx b/app/(pages)/admin/hackbot/page.tsx
new file mode 100644
index 000000000..4825afe3e
--- /dev/null
+++ b/app/(pages)/admin/hackbot/page.tsx
@@ -0,0 +1,25 @@
+import HackbotKnowledgeProvider from '../_contexts/HackbotKnowledgeContext';
+import KnowledgeToolbar from '../_components/Hackbot/KnowledgeToolbar';
+import KnowledgeBanners from '../_components/Hackbot/KnowledgeBanners';
+import KnowledgeImportPreview from '../_components/Hackbot/KnowledgeImportPreview';
+import KnowledgeTable from '../_components/Hackbot/KnowledgeTable';
+import KnowledgeDocModal from '../_components/Hackbot/KnowledgeDocModal';
+import KnowledgeLoadState from '../_components/Hackbot/KnowledgeLoadState';
+import HackbotUsageMetrics from '../_components/Hackbot/HackbotUsageMetrics';
+
+export default function HackbotKnowledgePage() {
+  return (
+    <HackbotKnowledgeProvider>
+      <KnowledgeLoadState>
+        <div className="p-8 flex flex-col gap-6">
+          <HackbotUsageMetrics />
+          <KnowledgeToolbar />
+          <KnowledgeBanners />
+          <KnowledgeImportPreview />
+          <KnowledgeTable />
+          <KnowledgeDocModal />
+        </div>
+      </KnowledgeLoadState>
+    </HackbotKnowledgeProvider>
+  );
+}
diff --git a/app/(pages)/admin/page.tsx b/app/(pages)/admin/page.tsx
index dba3f7e2c..922b558c9 100644
--- a/app/(pages)/admin/page.tsx
+++ b/app/(pages)/admin/page.tsx
@@ -37,6 +37,10 @@ const action_links = [
     href: '/admin/announcements',
     body: 'Announcements',
   },
+  {
+    href: '/admin/hackbot',
+    body: 'HackBot Knowledge',
+  },
 ];
 
 const data_links = [