Core utilities and models for the Agent Plane CLI.
npm install @agentplaneorg/core


Core utilities and models used by the agentplane CLI. This package exposes the reusable building blocks
for project discovery, config handling, task readme parsing, and task export/linting.
If you are an end-user, install the CLI instead: https://www.npmjs.com/package/agentplane
``bash`
npm install -g agentplane
agentplane init
agentplane quickstart
agentplane task new --title "First task" --description "Describe the change" --priority med --owner ORCHESTRATOR --tag docs
agentplane verify
agentplane finish
`bash`
npm install @agentplaneorg/core
- Node.js >= 20
- ESM-only (type: module)
`ts
import {
resolveProject,
loadConfig,
listTasks,
readTask,
buildTasksExportSnapshot,
} from "@agentplaneorg/core";
const project = await resolveProject(process.cwd());
const config = await loadConfig(project.root);
const tasks = await listTasks(project.root);
const task = await readTask(project.root, tasks[0]?.id ?? "");
const snapshot = await buildTasksExportSnapshot(project.root);
console.log(config.data.workflow_mode, task?.id, snapshot.meta.version);
`
| Area | Highlights |
| ----------------- | -------------------------------------------------------------- |
| Project discovery | resolveProject, findGitRoot |loadConfig
| Config | , saveConfig, setByDottedKey, validateConfig |parseTaskReadme
| Task README | , renderTaskReadme |createTask
| Task store | , listTasks, readTask, setTaskDocSection |buildTasksExportSnapshot
| Exports | , writeTasksExport, checksums |lintTasksFile
| Linting | , lintTasksSnapshot |getStagedFiles
| Git | , getUnstagedFiles, base branch helpers |validateCommitSubject
| Commit policy | , extractTaskSuffix |
This package is versioned alongside the CLI and is primarily used by agentplane`. The API is stable for
current use cases, but expect changes as the CLI evolves.
- Repository: https://github.com/basilisk-labs/agentplane
- Developer docs: https://github.com/basilisk-labs/agentplane/tree/main/docs
MIT