@cjournois/repo-toolkit (0.1.1)
Installation
@cjournois:registry=npm install @cjournois/repo-toolkit@0.1.1"@cjournois/repo-toolkit": "0.1.1"About this package
@cjournois/repo-toolkit
TypeScript toolkit for validating repository automation configs, diffing desired vs local state, and (eventually) applying changes through Forgejo adapters. Ships the repo-toolkit CLI.
Proprietary — Copyright (c) 2026 cjournois. All rights reserved. SPDX: UNLICENSED. See LICENSE for terms.
Install
bun add -d @cjournois/repo-toolkit
Or run without installing:
bunx @cjournois/repo-toolkit validate
CLI
Global flags: -c, --config <path> (defaults to ./repo-toolkit.json), -s, --state <path> (defaults to .repo-toolkit/state.json).
| Command | Description |
|---|---|
repo-toolkit validate |
Load config, normalize repos, print names. |
repo-toolkit plan [--repo <name>] [--json] |
Show diffs between desired config and the adapter's current state. |
repo-toolkit apply [--repo <name>] [--dry-run] [--json] |
Apply changes through the active adapter. Use --dry-run to preview without writes. |
repo-toolkit inspect <repoName> |
Print current state of a single repo as JSON via the active adapter. |
Set FORGEJO_TOKEN (and optionally FORGEJO_URL) to target Forgejo; otherwise the local JSON fixture adapter is used (-s path).
Configuration
Config is JSON only. Create a repo-toolkit.json at the repo root:
{
"$schema": "./node_modules/@cjournois/repo-toolkit/schema.json",
"extends": ["local>devops/config//repo-toolkit/organization"],
"repos": []
}
extends uses Renovate-style refs (local>owner/repo//path/to/file) resolved from the monorepo root.
Source
Repository: git.journois.com/cjournois/library
Dependencies
Dependencies
| ID | Version |
|---|---|
| commander | ^15.0.0 |
| zod | ^4.3.6 |
Development dependencies
| ID | Version |
|---|---|
| @biomejs/biome | 2.5.1 |
| @cjournois/biome-config-ts | ^0.1.0 |
| @cjournois/eslint-config-ts | ^0.1.0 |
| @eslint/js | ^9.39.4 |
| @types/bun | 1.3.14 |
| eslint | ^9.39.4 |
| eslint-plugin-import | ^2.32.0 |
| globals | ^17.4.0 |
| tsdown | ^0.22.0 |
| typescript | ^6.0.0 |
| typescript-eslint | ^8.58.0 |
| zod-to-json-schema | ^3.24.5 |