@kognai/new

Scaffold a new Kognai agent in your sovereign vault. Closes the loop after npx @kognai/init (vault) → npx @kognai/run (execute) → npx @kognai/new (create your own agent).

# scaffold a vault first if you haven't
npx @kognai/init

# create a new agent (interactive)
npx @kognai/new analyst

# create a new agent (non-interactive)
npx @kognai/new code-reviewer \
  --role "Reviews code for bugs and style" \
  --llm anthropic/claude-haiku-4-5-20251001 \
  --vibe "blunt, surgical, refuses to lie about quality" \
  --no-input

# then run it
echo "review this snippet: ..." | npx @kognai/run code-reviewer

Naming rules

Lowercase letters, digits, and hyphens only. Must start with a letter. Length 2–40 characters. Examples: analyst, code-reviewer, customer-support-1.

What gets written

.kognai/agents/<name>/
├── agent.yaml    # name, role, llm, fallback_llm, prompt path
└── prompt.md     # the agent's system prompt — edit to taste

The generated prompt.md ships with sensible defaults: no chain-of-thought leaking into output, no unrequested preamble, refusal-cites-the-Charter on harmful asks. Edit freely once the agent exists.

Options

| Flag | Default | Notes | |------------------|--------------|------------------------------------------------| | --vault <path> | ./.kognai | Vault directory | | --role <text> | interactive | One-sentence role description | | --llm <p/m> | interactive | e.g. ollama/qwen3:14b | | --vibe <text> | interactive | One-phrase personality / tone | | --force | off | Overwrite an existing agent | | --no-input | off | Skip prompts; use defaults for unset fields | | --help, -h | — | Show usage |

Zero npm dependencies

Raw fs + readline. The agent.yaml/prompt.md templates are inlined as constants, no template engine.

License

MIT