Saltar al contenido principal

agent-kitagent-kit

Todo lo que necesita un agente sobre el Claude Agent SDK, resuelto una vez: supervisión humana, seguridad, memoria y una interfaz de terminal. Tú solo escribes tu dominio.

npm install @falkenslab/agent-kit

La supervisión que elijas

Autónomo, guiado (aprobación antes de todo lo visible o difícil de deshacer) o paso a paso. Cambia entre guiado y paso a paso en mitad de una conversación.

Salvaguardas en hooks, no en prompts

Ámbito de ficheros, rutas protegidas, Bash solo para subagentes, solo los subagentes declarados, siempre en primer plano. Se aplican en cada llamada a una herramienta.

Memoria entre sesiones

Una base de conocimiento integrada que el agente mantiene como una wiki, los originales intactos, y cada conversación reanudable con --continue o /resume.

Una interfaz de terminal como Claude Code

Chat Ink a pantalla completa con markdown en vivo, llamadas a herramientas plegadas, paneles de aprobación, búsqueda en el historial, menciones de ficheros, temas y cuatro idiomas.

Tu dominio, nada más

Un AgentSpec dice quién es el agente y qué tiene: prompt, servidores MCP, skills, subagentes. El kit monta la sesión a su alrededor.

También sin terminal

El núcleo nunca toca el terminal: maneja el mismo agente desde una aplicación Electron o un servidor, con un flujo de eventos normalizado.

Un agente entero en un fichero

El spec dice quién es el agente; buildSessionOptions() lo convierte en las opciones de sesión del SDK, con las herramientas, los hooks y las salvaguardas del modo elegido; runChatInk() le da un chat a pantalla completa cuyas conversaciones se pueden reanudar.

import path from "node:path";
import { buildSessionOptions, ensureClaudeAuth, runChatInk, type AgentSpec, type BaseSessionConfig } from "@falkenslab/agent-kit";

const spec: AgentSpec<BaseSessionConfig> = {
buildSystemPrompt: () => "You are a pirate cat who tells jokes. Always answer in character.",
buildMcpServers: () => ({}),
pluginRoots: () => [],
buildSubagents: () => undefined,
};

await ensureClaudeAuth();
const config: BaseSessionConfig = { mode: "guided", projectDir: process.cwd() };

await runChatInk((run) => buildSessionOptions(config, run.dir, spec, { run }), {
runsDir: path.resolve(".run"),
header: { title: "My agent" },
mode: config.mode,
fullscreen: true,
});

Captain Whiskers

El agente de ejemplo del kit: un gato pirata retirado con una tripulación de subagentes, sus propias herramientas y skills, un tema y sus textos en cuatro idiomas. Recórrelo.

Captain Whiskers a pantalla completa en Windows Terminal