Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { resolve as resolvePath } from 'node:path';
import { currentCliCommandName, isDetectedSkillInProject } from '@inkeep/open-knowledge-core';
import { resolveProjectIdentity } from '@inkeep/open-knowledge-core/shadow-repo-layout';
import { enumerateInstalledSkills } from '@inkeep/open-knowledge-core/skills-catalog';
import { findEnclosingProjectRoot, resolveLockDir } from '@inkeep/open-knowledge-server';
import { Command } from 'commander';
import { accent, dim, error as errorColor, info, success } from '../ui/colors.ts';
import { inspectLock } from './lock-state.ts';
export function skillsCommand(): Command {
const skills = new Command('skills').description(
'Manage Open Knowledge skills for this project.',
);
skills
.command('installed')
.description('List every skill installed across all your agents (read-only).')
.option('--json', 'Emit the raw enumeration as JSON.')
.action((opts: { json?: boolean }) => {
const cwd = resolvePath(process.cwd());
const identity = resolveProjectIdentity(findEnclosingProjectRoot(cwd)?.rootPath ?? cwd);
const enumerated = enumerateInstalledSkills({ projectDir: identity });
const result = {
...enumerated,
skills: enumerated.skills.filter((s) => isDetectedSkillInProject(s.provenance, identity)),
};
if (opts.json) {
process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
return;
}
if (result.skills.length === 0) {
process.stdout.write(`${dim('No installed skills found across any agent.')}\n`);
return;
}
process.stdout.write(`${accent(`${result.skills.length} installed skill(s):`)}\n`);
for (const s of result.skills) {
const ver = s.provenance.version ? dim(` v${s.provenance.version}`) : '';
const cap = [
s.inert.commands && 'commands',
s.inert.hooks && 'hooks',
s.inert.mcp && 'mcp',
].filter(Boolean);
const capStr = cap.length > 0 ? dim(` [${cap.join(', ')}]`) : '';
process.stdout.write(
` ${success(s.name)}${ver} ${dim(s.sourceHarnesses.join(', '))}${capStr}\n`,
);
}
process.stdout.write(`\n${accent(`${result.packs.length} pack(s):`)}\n`);
for (const p of result.packs) {
process.stdout.write(
` ${info(p.name)} ${dim(`v${p.version}`)} — ${p.skills.length} skill(s)\n`,
);
}
});
skills
.command('import <source>')
.description(
'Import a skill into this project as versioned content (github owner/repo, a git URL, or a local path).',
)
.option('--skill <name>', 'Pick one skill from a multi-skill source.')
.option('--scope <scope>', 'project (default) or global.', 'project')
.action(async (source: string, opts: { skill?: string; scope?: string }) => {
const lockDir = resolveLockDir(process.cwd());
const state = inspectLock(lockDir, 'server');
if (state.status !== 'alive') {
process.stderr.write(
`${errorColor('Error:')} no running Open Knowledge server for this project. Start it with ${accent(`${currentCliCommandName()} start`)} and retry.\n`,
);
process.exitCode = 1;
return;
}
let res: Response;
try {
res = await fetch(`http://127.0.0.1:${state.lock.port}/api/skill/import`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
source,
...(opts.skill ? { skill: opts.skill } : {}),
scope: opts.scope === 'global' ? 'global' : 'project',
}),
});
} catch (err) {
const msg = err instanceof Error ? err.message : String(err);
process.stderr.write(`${errorColor('Error:')} could not reach the server: ${msg}\n`);
process.exitCode = 1;
return;
}
const body = (await res.json().catch(() => ({}))) as Record<string, unknown>;
if (!res.ok) {
const title = typeof body.title === 'string' ? body.title : undefined;
const detail = typeof body.detail === 'string' ? body.detail : undefined;
const message = title
? detail
? `${title} (${detail})`
: title
: (detail ?? `HTTP ${res.status}`);
process.stderr.write(`${errorColor('Import failed:')} ${message}\n`);
process.exitCode = 1;
return;
}
const name = body.name as string;
if (body.alreadyImported) {
process.stdout.write(`${info('Already imported:')} ${accent(name)} (identical content).\n`);
return;
}
const prov = (body.provenance ?? {}) as { source?: string; publisher?: string };
const renamed = body.collisionRenamedFrom as string | undefined;
process.stdout.write(
`${success('Imported')} ${accent(name)}${renamed ? dim(` (renamed from ${renamed} — name was taken)`) : ''} from ${dim(prov.source ?? source)}${prov.publisher ? dim(` · ${prov.publisher}`) : ''}.\n` +
`${dim("Saved as versioned content in this project's skill home. Scripts shown, never run. Use the skill's install menu (or the install MCP verb) to add it to your other editors.")}\n`,
);
for (const w of (body.warnings as string[]) ?? []) {
process.stdout.write(` ${dim(`! ${w}`)}\n`);
}
});
return skills;
}