5ad2e50d69
- cortex/static/TOOLS.md — tool reference extracted from HELP.md; uses ##
headers so each category is collapsible. All 30 tools with descriptions.
- cortex/static/HELP.md — UI guide only; tools section replaced with a
one-line pointer to the Tools tab.
- help.html — three tabs (UI Guide / Tools / Persona); tab choice persists
in localStorage. Tools tab defaults all sections open. Persona tab shows
home/{user}/persona/{name}/HELP.md with an empty-state message if unset.
- context_loader.py — loads cortex/static/TOOLS.md into context at tier 2+
(replaces the previously empty persona HELP.md load). Persona HELP.md
still loaded if non-empty, as persona-specific additions.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
264 lines
11 KiB
HTML
264 lines
11 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Cortex — Help & Reference</title>
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@100..900&display=swap" rel="stylesheet">
|
|
<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
|
|
<script>(function(){var t=localStorage.getItem('theme')||(window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light');document.documentElement.setAttribute('data-theme',t);})();</script>
|
|
<style>
|
|
:root {
|
|
--pg-bg: #0f1117; --pg-surface: #1a1d27;
|
|
--pg-border: #2d3148;
|
|
--pg-text: #e2e8f0; --pg-muted: #94a3b8;
|
|
--pg-dim: #64748b; --pg-dimmer: #475569;
|
|
--pg-bright: #cbd5e1; --pg-nav-hover: rgba(255,255,255,0.05);
|
|
--pg-accent: #a78bfa;
|
|
}
|
|
[data-theme="light"] {
|
|
--pg-bg: #f4f2fa; --pg-surface: #ffffff;
|
|
--pg-border: #d0c8e8;
|
|
--pg-text: #1a1228; --pg-muted: #5a5478;
|
|
--pg-dim: #7a7290; --pg-dimmer: #9e98b0;
|
|
--pg-bright: #1a1228; --pg-nav-hover: rgba(0,0,0,0.05);
|
|
--pg-accent: #7c3aed;
|
|
}
|
|
|
|
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
|
|
|
|
body {
|
|
min-height: 100vh;
|
|
background: var(--pg-bg);
|
|
font-family: 'Inter', system-ui, -apple-system, sans-serif;
|
|
font-weight: 450;
|
|
-webkit-font-smoothing: antialiased;
|
|
-moz-osx-font-smoothing: grayscale;
|
|
color: var(--pg-text);
|
|
padding: 2rem 1.5rem;
|
|
}
|
|
|
|
.page { max-width: 720px; margin: 0 auto; }
|
|
|
|
/* ── Page nav ── */
|
|
.page-nav {
|
|
display: flex; align-items: center; gap: 0.25rem;
|
|
margin-bottom: 1.75rem; flex-wrap: wrap;
|
|
}
|
|
.nav-link {
|
|
display: inline-flex; align-items: center;
|
|
padding: 0.3rem 0.6rem; border-radius: 6px;
|
|
font-size: 0.8rem; font-weight: 500; color: var(--pg-dim);
|
|
text-decoration: none; transition: color 0.15s, background 0.15s; white-space: nowrap;
|
|
}
|
|
.nav-link:hover { color: var(--pg-bright); background: var(--pg-nav-hover); }
|
|
.nav-link.active { color: var(--pg-accent); }
|
|
.nav-spacer { flex: 1; min-width: 0.5rem; }
|
|
.nav-link.nav-logout { color: var(--pg-dimmer); }
|
|
.nav-link.nav-logout:hover { color: var(--pg-muted); background: none; }
|
|
|
|
/* ── Header ── */
|
|
header { margin-bottom: 1.5rem; padding-bottom: 1rem; border-bottom: 1px solid var(--pg-border); }
|
|
header h1 { font-size: 1.5rem; font-weight: 700; color: var(--pg-accent); }
|
|
header p { font-size: 0.85rem; color: var(--pg-muted); margin-top: 0.25rem; }
|
|
|
|
/* ── Tabs ── */
|
|
.tab-bar {
|
|
display: flex; gap: 0.25rem;
|
|
margin-bottom: 1.25rem;
|
|
border-bottom: 1px solid var(--pg-border);
|
|
padding-bottom: 0;
|
|
}
|
|
.tab-btn {
|
|
padding: 0.45rem 1rem;
|
|
font-size: 0.85rem; font-weight: 500;
|
|
color: var(--pg-dim);
|
|
background: none; border: none; border-bottom: 2px solid transparent;
|
|
cursor: pointer; transition: color 0.15s, border-color 0.15s;
|
|
margin-bottom: -1px;
|
|
}
|
|
.tab-btn:hover { color: var(--pg-bright); }
|
|
.tab-btn.active { color: var(--pg-accent); border-bottom-color: var(--pg-accent); }
|
|
|
|
.tab-panel { display: none; }
|
|
.tab-panel.active { display: block; }
|
|
|
|
/* ── Content ── */
|
|
.help-body { line-height: 1.7; }
|
|
|
|
details {
|
|
margin-bottom: 0.75rem;
|
|
background: var(--pg-surface);
|
|
border: 1px solid var(--pg-border);
|
|
border-radius: 8px; overflow: hidden;
|
|
}
|
|
summary {
|
|
padding: 0.85rem 1rem; font-weight: 600; font-size: 0.95rem;
|
|
color: var(--pg-bright); cursor: pointer; list-style: none;
|
|
display: flex; align-items: center; gap: 0.5rem;
|
|
}
|
|
summary::before {
|
|
content: '▶'; font-size: 0.65rem; color: var(--pg-muted);
|
|
transition: transform 0.15s;
|
|
}
|
|
details[open] summary::before { transform: rotate(90deg); }
|
|
summary::-webkit-details-marker { display: none; }
|
|
details > *:not(summary) { padding: 0 1rem 1rem; }
|
|
|
|
.help-body p { margin: 0.5rem 0; font-size: 0.9rem; color: var(--pg-bright); }
|
|
.help-body ul { margin: 0.5rem 0 0.5rem 1.25rem; }
|
|
.help-body li { font-size: 0.9rem; color: var(--pg-bright); margin-bottom: 0.25rem; }
|
|
.help-body strong { color: var(--pg-text); }
|
|
.help-body code {
|
|
background: var(--pg-bg); border: 1px solid var(--pg-border);
|
|
border-radius: 4px; padding: 0.1em 0.4em;
|
|
font-size: 0.85em; color: var(--pg-accent);
|
|
}
|
|
.help-body a { color: var(--pg-accent); }
|
|
.help-body h1 { font-size: 1.1rem; font-weight: 700; color: var(--pg-text); margin: 0.75rem 0 0.5rem; }
|
|
.help-body h3 {
|
|
font-size: 0.8rem; font-weight: 600; color: var(--pg-muted);
|
|
text-transform: uppercase; letter-spacing: 0.05em; margin: 0.75rem 0 0.25rem;
|
|
}
|
|
.help-body table { width: 100%; border-collapse: collapse; font-size: 0.88rem; margin: 0.5rem 0 0.75rem; }
|
|
.help-body th, .help-body td { padding: 0.45rem 0.7rem; text-align: left; border-bottom: 1px solid var(--pg-border); }
|
|
.help-body th { color: var(--pg-muted); font-weight: 600; font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.04em; }
|
|
.help-body td { color: var(--pg-bright); }
|
|
.help-body pre { background: var(--pg-bg); border: 1px solid var(--pg-border); border-radius: 6px; padding: 0.75rem 1rem; overflow-x: auto; margin: 0.5rem 0; }
|
|
.help-body pre code { background: none; border: none; padding: 0; font-size: 0.85em; color: var(--pg-muted); }
|
|
.help-body hr { border: none; border-top: 1px solid var(--pg-border); margin: 0.5rem 0; }
|
|
|
|
.empty-state { color: var(--pg-dim); font-size: 0.9rem; padding: 2rem 0; text-align: center; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="page">
|
|
<nav class="page-nav" id="page-nav">
|
|
<a id="nav-chat" href="/" class="nav-link">← Chat</a>
|
|
<a href="/help" class="nav-link active">Help</a>
|
|
<a href="/settings" class="nav-link" id="nav-settings">Settings</a>
|
|
<span class="nav-spacer"></span>
|
|
<a href="/logout" class="nav-link nav-logout">Sign out</a>
|
|
</nav>
|
|
|
|
<header>
|
|
<h1>Help & Reference</h1>
|
|
<p id="persona-label"></p>
|
|
</header>
|
|
|
|
<div class="tab-bar">
|
|
<button class="tab-btn active" data-tab="ui">UI Guide</button>
|
|
<button class="tab-btn" data-tab="tools">Tools</button>
|
|
<button class="tab-btn" data-tab="persona" id="tab-btn-persona">Persona</button>
|
|
</div>
|
|
|
|
<div id="tab-ui" class="tab-panel active"><div class="help-body"><p class="empty-state">Loading…</p></div></div>
|
|
<div id="tab-tools" class="tab-panel"> <div class="help-body"><p class="empty-state">Loading…</p></div></div>
|
|
<div id="tab-persona" class="tab-panel"> <div class="help-body"><p class="empty-state">Loading…</p></div></div>
|
|
</div>
|
|
|
|
<script>
|
|
const cfg = window.HELP_CONFIG || {};
|
|
const user = cfg.user || 'scott';
|
|
const persona = cfg.persona || 'inara';
|
|
const params = `user=${encodeURIComponent(user)}&persona=${encodeURIComponent(persona)}`;
|
|
|
|
document.getElementById('nav-chat').href = cfg.backHref || '/';
|
|
if (persona) {
|
|
document.getElementById('persona-label').textContent =
|
|
`${persona.charAt(0).toUpperCase() + persona.slice(1)} · ${user}`;
|
|
}
|
|
|
|
// Rename Persona tab to the actual persona name
|
|
const personaTabBtn = document.getElementById('tab-btn-persona');
|
|
personaTabBtn.textContent = persona.charAt(0).toUpperCase() + persona.slice(1);
|
|
|
|
// ── Tab switching ────────────────────────────────────────────────
|
|
const tabBtns = document.querySelectorAll('.tab-btn');
|
|
const tabPanels = document.querySelectorAll('.tab-panel');
|
|
const TAB_KEY = `cx_help_tab_${user}_${persona}`;
|
|
|
|
function activateTab(name) {
|
|
tabBtns.forEach(b => b.classList.toggle('active', b.dataset.tab === name));
|
|
tabPanels.forEach(p => p.classList.toggle('active', p.id === `tab-${name}`));
|
|
try { localStorage.setItem(TAB_KEY, name); } catch (_) {}
|
|
}
|
|
|
|
tabBtns.forEach(btn => btn.addEventListener('click', () => activateTab(btn.dataset.tab)));
|
|
|
|
// Restore last active tab
|
|
try {
|
|
const saved = localStorage.getItem(TAB_KEY);
|
|
if (saved) activateTab(saved);
|
|
} catch (_) {}
|
|
|
|
// ── Collapsible h2 sections ──────────────────────────────────────
|
|
function makeCollapsible(container, openAll = false, openSet = null) {
|
|
container.querySelectorAll('h2').forEach(h2 => {
|
|
const title = h2.textContent.trim();
|
|
const details = document.createElement('details');
|
|
if (openAll || (openSet && openSet.has(title))) details.open = true;
|
|
|
|
const summary = document.createElement('summary');
|
|
summary.textContent = title;
|
|
details.appendChild(summary);
|
|
|
|
const siblings = [];
|
|
let node = h2.nextSibling;
|
|
while (node && node.nodeName !== 'H2') { siblings.push(node); node = node.nextSibling; }
|
|
siblings.forEach(s => details.appendChild(s));
|
|
h2.parentNode.replaceChild(details, h2);
|
|
});
|
|
}
|
|
|
|
// ── Render markdown into a panel ────────────────────────────────
|
|
function render(panelId, markdown, openAll, openSet) {
|
|
const panel = document.querySelector(`#${panelId} .help-body`);
|
|
panel.innerHTML = marked.parse(markdown);
|
|
panel.querySelectorAll('a').forEach(a => { a.target = '_blank'; a.rel = 'noopener noreferrer'; });
|
|
makeCollapsible(panel, openAll, openSet);
|
|
}
|
|
|
|
// ── Load all three tabs in parallel ─────────────────────────────
|
|
const UI_OPEN = new Set(['Header Controls', 'Chat', 'Sessions', 'Notes']);
|
|
|
|
async function loadAll() {
|
|
// UI Guide
|
|
fetch('/static/HELP.md')
|
|
.then(r => r.ok ? r.text() : Promise.reject(r.status))
|
|
.then(md => render('tab-ui', md, false, UI_OPEN))
|
|
.catch(e => { document.querySelector('#tab-ui .help-body').innerHTML = `<p class="empty-state">Failed to load: ${e}</p>`; });
|
|
|
|
// Tools
|
|
fetch('/static/TOOLS.md')
|
|
.then(r => r.ok ? r.text() : Promise.reject(r.status))
|
|
.then(md => render('tab-tools', md, true, null))
|
|
.catch(e => { document.querySelector('#tab-tools .help-body').innerHTML = `<p class="empty-state">Failed to load: ${e}</p>`; });
|
|
|
|
// Persona-specific HELP.md
|
|
const personaPanel = document.querySelector('#tab-persona .help-body');
|
|
try {
|
|
const res = await fetch(`/files/HELP.md?${params}`);
|
|
if (res.ok) {
|
|
const data = await res.json();
|
|
const content = (data.content || '').trim();
|
|
if (content) {
|
|
render('tab-persona', content, true, null);
|
|
} else {
|
|
personaPanel.innerHTML = `<p class="empty-state">No ${persona}-specific notes yet. Edit <code>HELP.md</code> in the Files panel to add them.</p>`;
|
|
}
|
|
} else {
|
|
personaPanel.innerHTML = `<p class="empty-state">No ${persona}-specific notes yet.</p>`;
|
|
}
|
|
} catch (_) {
|
|
personaPanel.innerHTML = `<p class="empty-state">No ${persona}-specific notes yet.</p>`;
|
|
}
|
|
}
|
|
|
|
loadAll();
|
|
</script>
|
|
</body>
|
|
</html>
|