azdo-cli 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +79 -0
- package/dist/index.js +21 -0
- package/package.json +33 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Beads Contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# bd - Beads
|
|
2
|
+
|
|
3
|
+
**Distributed, git-backed graph issue tracker for AI agents.**
|
|
4
|
+
|
|
5
|
+
**Platforms:** macOS, Linux, Windows, FreeBSD
|
|
6
|
+
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
[](https://goreportcard.com/report/github.com/steveyegge/beads)
|
|
9
|
+
[](https://github.com/steveyegge/beads/releases)
|
|
10
|
+
[](https://www.npmjs.com/package/@beads/bd)
|
|
11
|
+
[](https://pypi.org/project/beads-mcp/)
|
|
12
|
+
|
|
13
|
+
Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.
|
|
14
|
+
|
|
15
|
+
## ⚡ Quick Start
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
# Install beads CLI (system-wide - don't clone this repo into your project)
|
|
19
|
+
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
|
|
20
|
+
|
|
21
|
+
# Initialize in YOUR project
|
|
22
|
+
cd your-project
|
|
23
|
+
bd init
|
|
24
|
+
|
|
25
|
+
# Tell your agent
|
|
26
|
+
echo "Use 'bd' for task tracking" >> AGENTS.md
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**Note:** Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.
|
|
30
|
+
|
|
31
|
+
## 🛠 Features
|
|
32
|
+
|
|
33
|
+
* **Git as Database:** Issues stored as JSONL in `.beads/`. Versioned, branched, and merged like code.
|
|
34
|
+
* **Agent-Optimized:** JSON output, dependency tracking, and auto-ready task detection.
|
|
35
|
+
* **Zero Conflict:** Hash-based IDs (`bd-a1b2`) prevent merge collisions in multi-agent/multi-branch workflows.
|
|
36
|
+
* **Invisible Infrastructure:** SQLite local cache for speed; background daemon for auto-sync.
|
|
37
|
+
* **Compaction:** Semantic "memory decay" summarizes old closed tasks to save context window.
|
|
38
|
+
|
|
39
|
+
## 📖 Essential Commands
|
|
40
|
+
|
|
41
|
+
| Command | Action |
|
|
42
|
+
| --- | --- |
|
|
43
|
+
| `bd ready` | List tasks with no open blockers. |
|
|
44
|
+
| `bd create "Title" -p 0` | Create a P0 task. |
|
|
45
|
+
| `bd update <id> --claim` | Atomically claim a task (sets assignee + in_progress). |
|
|
46
|
+
| `bd dep add <child> <parent>` | Link tasks (blocks, related, parent-child). |
|
|
47
|
+
| `bd show <id>` | View task details and audit trail. |
|
|
48
|
+
|
|
49
|
+
## 🔗 Hierarchy & Workflow
|
|
50
|
+
|
|
51
|
+
Beads supports hierarchical IDs for epics:
|
|
52
|
+
|
|
53
|
+
* `bd-a3f8` (Epic)
|
|
54
|
+
* `bd-a3f8.1` (Task)
|
|
55
|
+
* `bd-a3f8.1.1` (Sub-task)
|
|
56
|
+
|
|
57
|
+
**Stealth Mode:** Run `bd init --stealth` to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects.
|
|
58
|
+
|
|
59
|
+
**Contributor vs Maintainer:** When working on open-source projects:
|
|
60
|
+
|
|
61
|
+
* **Contributors** (forked repos): Run `bd init --contributor` to route planning issues to a separate repo (e.g., `~/.beads-planning`). Keeps experimental work out of PRs.
|
|
62
|
+
* **Maintainers** (write access): Beads auto-detects maintainer role via SSH URLs or HTTPS with credentials. Only need `git config beads.role maintainer` if using GitHub HTTPS without credentials but you have write access.
|
|
63
|
+
|
|
64
|
+
## 📦 Installation
|
|
65
|
+
|
|
66
|
+
* **npm:** `npm install -g @beads/bd`
|
|
67
|
+
* **Homebrew:** `brew install beads`
|
|
68
|
+
* **Go:** `go install github.com/steveyegge/beads/cmd/bd@latest`
|
|
69
|
+
|
|
70
|
+
**Requirements:** Linux, FreeBSD, macOS, or Windows.
|
|
71
|
+
|
|
72
|
+
## 🌐 Community Tools
|
|
73
|
+
|
|
74
|
+
See [docs/COMMUNITY_TOOLS.md](docs/COMMUNITY_TOOLS.md) for a curated list of community-built UIs, extensions, and integrations—including terminal interfaces, web UIs, editor extensions, and native apps.
|
|
75
|
+
|
|
76
|
+
## 📝 Documentation
|
|
77
|
+
|
|
78
|
+
* [Installing](docs/INSTALLING.md) | [Agent Workflow](AGENT_INSTRUCTIONS.md) | [Copilot Setup](docs/COPILOT_INTEGRATION.md) | [Articles](ARTICLES.md) | [Sync Branch Mode](docs/PROTECTED_BRANCHES.md) | [Troubleshooting](docs/TROUBLESHOOTING.md) | [FAQ](docs/FAQ.md)
|
|
79
|
+
* [](https://deepwiki.com/steveyegge/beads)
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// src/index.ts
|
|
4
|
+
import { Command } from "commander";
|
|
5
|
+
|
|
6
|
+
// src/version.ts
|
|
7
|
+
import { readFileSync } from "fs";
|
|
8
|
+
import { fileURLToPath } from "url";
|
|
9
|
+
import { dirname, resolve } from "path";
|
|
10
|
+
var __dirname = dirname(fileURLToPath(import.meta.url));
|
|
11
|
+
var pkg = JSON.parse(readFileSync(resolve(__dirname, "../package.json"), "utf-8"));
|
|
12
|
+
var version = pkg.version;
|
|
13
|
+
|
|
14
|
+
// src/index.ts
|
|
15
|
+
var program = new Command();
|
|
16
|
+
program.name("azdo").description("Azure DevOps CLI tool").version(version, "-v, --version");
|
|
17
|
+
program.showHelpAfterError();
|
|
18
|
+
program.parse();
|
|
19
|
+
if (process.argv.length <= 2) {
|
|
20
|
+
program.help();
|
|
21
|
+
}
|
package/package.json
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "azdo-cli",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Azure DevOps CLI tool",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"azdo": "./dist/index.js"
|
|
8
|
+
},
|
|
9
|
+
"files": [
|
|
10
|
+
"dist"
|
|
11
|
+
],
|
|
12
|
+
"scripts": {
|
|
13
|
+
"build": "tsup",
|
|
14
|
+
"lint": "eslint src/",
|
|
15
|
+
"typecheck": "tsc --noEmit",
|
|
16
|
+
"format": "prettier --check src/",
|
|
17
|
+
"test": "vitest run"
|
|
18
|
+
},
|
|
19
|
+
"license": "MIT",
|
|
20
|
+
"dependencies": {
|
|
21
|
+
"commander": "^14.0.3"
|
|
22
|
+
},
|
|
23
|
+
"devDependencies": {
|
|
24
|
+
"@eslint/js": "^10.0.1",
|
|
25
|
+
"@types/node": "^25.3.3",
|
|
26
|
+
"eslint": "^10.0.2",
|
|
27
|
+
"prettier": "^3.8.1",
|
|
28
|
+
"tsup": "^8.5.1",
|
|
29
|
+
"typescript": "^5.9.3",
|
|
30
|
+
"typescript-eslint": "^8.56.1",
|
|
31
|
+
"vitest": "^4.0.18"
|
|
32
|
+
}
|
|
33
|
+
}
|