Agent kernel ops

Skill imMamdouhaboammar/agent-kernel/skills/agent-kernel-ops

Operational guide for agents working with Agent Kernel v1.20.0+ — environment vault, memory proposals, policies, installation, and diagnosticsFrom its SKILL.md

Install

npx -y skills add imMamdouhaboammar/agent-kernel --skill agent-kernel-ops

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.0 KB, as published. Nobody here has run it

Agent Kernel Universal Operations Guide

Use this skill when the user mentions agent-kernel, .env, Environment Vault, memory proposals, agent rules, policies, or runtime diagnostics

Environment Vault safety rules

Never print, summarize, diff, log, or paste environment file contents
Start with agent-kernel env status [project]
Use agent-kernel env doctor [project] when the vault is unhealthy or permissions drift
Use normal pull for missing files
Do not use --force until the user understands that a differing local file will be replaced
Keep backups enabled during forced restore unless the user explicitly requests otherwise
Use unlink to detach a project path while retaining stored files
Use purge --yes only after an explicit request to delete the stored vault
Reject symlinks, non-regular files, paths outside the project root, and unstable project identity

Environment Vault commands

Link the project and discover eligible environment files

agent-kernel env link [project]

Link exact Monorepo files

agent-kernel env link [project] \
  --include apps/api/.env \
  --include apps/web/.env.local

Check identity, health, and file states

agent-kernel env status [project]
agent-kernel env status [project] --json

Store local edits

agent-kernel env push [project]
agent-kernel env push [project] --file apps/api/.env

Preview without writing

agent-kernel env push [project] --dry-run

Restore missing files

agent-kernel env pull [project]

Handle an intentional overwrite with a backup

agent-kernel env pull [project] --force

Run health checks and repair POSIX permissions

agent-kernel env doctor [project]
agent-kernel env doctor [project] --repair-permissions

Migrate a matching legacy vault after inspection

agent-kernel env doctor [project] --migrate

Inspect vault health in JSON

agent-kernel env doctor [project] --json

Watch environment files edited outside an Agent Kernel hook

agent-kernel env watch [project]

Inspect revisions without secret contents

agent-kernel env history [project] --file .env

Restore one revision with normal conflict handling

agent-kernel env restore [project] --file .env --revision <revision-id>

Detach automatic behavior while retaining stored data

agent-kernel env unlink [project]

Delete stored data only after explicit confirmation

agent-kernel env purge [project] --yes

List all local vault identities

agent-kernel env list --json

Read the complete command and security guide at docs/ENVIRONMENT_VAULT.md

Installation

With npm (requires Node.js >=18.18.0):

npm install -g @mamdouh-aboammar/agent-kernel
agent-kernel --version
agent-kernel init --sync

With Bun:

bun install -g @mamdouh-aboammar/agent-kernel
agent-kernel --version
agent-kernel init --sync

If agent-kernel is not found after Bun install, add Bun's bin directory to PATH:

export PATH="$HOME/.bun/bin:$PATH"

One-off (no global install):

npx -y @mamdouh-aboammar/agent-kernel --version
bunx @mamdouh-aboammar/agent-kernel --version

Current stable release: 1.20.0

Memory and rule proposals

Propose a new rule

agent-kernel propose --from <agentName> --text "Your rule text" --reason "Why"

Inspect the approval inbox

agent-kernel inbox

Approve and publish a proposal

agent-kernel approve <proposalId> --publish

Governance and quality guards

Run file and policy guards

agent-kernel guard [--staged|--file path]

Verify a named policy

agent-kernel policy check mandatory-bun-package-manager

Health and context diagnostics

Check Kernel status

agent-kernel status

Run the main health doctor

agent-kernel doctor