liteagents 2.4.0 → 2.4.1
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/CHANGELOG.md +67 -22
- package/README.md +13 -13
- package/cli.js +7 -7
- package/docs/CONTRIBUTING.md +2 -2
- package/docs/ERROR_HANDLING_IMPLEMENTATION.md +1 -1
- package/docs/INSTALLATION_DEMO.md +24 -24
- package/docs/INSTALLATION_LOCATIONS.md +23 -33
- package/docs/INSTALLER_GUIDE.md +85 -85
- package/docs/INTEGRATION_ISSUES_9.1.md +1 -1
- package/docs/KNOWLEDGE_BASE.md +8 -8
- package/docs/MIGRATION.md +2 -2
- package/docs/PACKAGE_BASELINE.md +1 -1
- package/docs/PASS_INTEGRATION.md +1 -1
- package/docs/PASS_QUICK_START.md +2 -2
- package/docs/PRIVACY.md +12 -12
- package/docs/PUBLISHING.md +50 -278
- package/docs/RELEASE_NOTES_1.2.0.md +14 -14
- package/docs/SECURITY.md +5 -5
- package/docs/SILENT_MODE_GUIDE.md +4 -4
- package/docs/SKILLS_CONVERSION.md +1 -1
- package/docs/TESTING.md +2 -2
- package/docs/TROUBLESHOOTING.md +2 -2
- package/docs/VARIANT_CONFIGURATION.md +5 -5
- package/installer/cli.js +3 -3
- package/installer/report-template.js +3 -3
- package/package.json +6 -9
- package/docs/DUAL_PUBLISH_SUMMARY.md +0 -177
- package/docs/GITHUB_PACKAGES.md +0 -181
- package/docs/GITHUB_SETUP.md +0 -158
|
@@ -443,7 +443,7 @@ echo "Exit code: $?"
|
|
|
443
443
|
|
|
444
444
|
2. **Review installation log:**
|
|
445
445
|
```bash
|
|
446
|
-
cat ~/.
|
|
446
|
+
cat ~/.liteagents-install.log
|
|
447
447
|
```
|
|
448
448
|
|
|
449
449
|
3. **Test without silent mode first:**
|
|
@@ -463,10 +463,10 @@ node -e "console.log(JSON.parse(require('fs').readFileSync('config.json', 'utf8'
|
|
|
463
463
|
If you encounter issues:
|
|
464
464
|
|
|
465
465
|
1. Check this guide for common scenarios
|
|
466
|
-
2. Review the installation log at `~/.
|
|
466
|
+
2. Review the installation log at `~/.liteagents-install.log`
|
|
467
467
|
3. Run with `--help` to see all available options
|
|
468
468
|
4. Try interactive mode first to diagnose issues
|
|
469
|
-
5. Report issues at: https://github.com/amrhas82/
|
|
469
|
+
5. Report issues at: https://github.com/amrhas82/liteagents/issues
|
|
470
470
|
|
|
471
471
|
## Best Practices
|
|
472
472
|
|
|
@@ -488,7 +488,7 @@ set -e # Exit on error
|
|
|
488
488
|
# Configuration
|
|
489
489
|
VARIANT="${AGENTIC_KIT_VARIANT:-lite}"
|
|
490
490
|
TOOLS="${AGENTIC_KIT_TOOLS:-claude}"
|
|
491
|
-
INSTALL_PATH="${AGENTIC_KIT_PATH:-/opt/
|
|
491
|
+
INSTALL_PATH="${AGENTIC_KIT_PATH:-/opt/liteagents}"
|
|
492
492
|
|
|
493
493
|
# Run installation
|
|
494
494
|
echo "Installing Agentic Kit ($VARIANT variant, tools: $TOOLS)..."
|
|
@@ -8,7 +8,7 @@ This document describes the transformation of 22 Claude skills from `~/.factory/
|
|
|
8
8
|
|
|
9
9
|
**Original Location**: `~/.factory/commands/`
|
|
10
10
|
**Total Skills Transformed**: 22
|
|
11
|
-
**Output Location**: `/home/hamr/PycharmProjects/
|
|
11
|
+
**Output Location**: `/home/hamr/PycharmProjects/liteagents/commands/`
|
|
12
12
|
|
|
13
13
|
## Conversion Process
|
|
14
14
|
|
package/docs/TESTING.md
CHANGED
|
@@ -127,7 +127,7 @@ node tests/installer/path-handling-testing.test.js
|
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
**Features Tested**:
|
|
130
|
-
- `~/.
|
|
130
|
+
- `~/.liteagents` → `/home/user/.liteagents`
|
|
131
131
|
- `./local` → `/current/directory/local`
|
|
132
132
|
- Path traversal prevention (`../../../etc/passwd` rejected)
|
|
133
133
|
- Unicode support (émoji, 中文, العربية)
|
|
@@ -384,7 +384,7 @@ Recommended quality gates:
|
|
|
384
384
|
**Solution**:
|
|
385
385
|
```bash
|
|
386
386
|
# Manual cleanup
|
|
387
|
-
rm -rf /tmp/
|
|
387
|
+
rm -rf /tmp/liteagents-test-*
|
|
388
388
|
rm -rf /tmp/variant-test-*
|
|
389
389
|
rm -rf /tmp/multi-tool-test-*
|
|
390
390
|
rm -rf /tmp/error-test-*
|
package/docs/TROUBLESHOOTING.md
CHANGED
|
@@ -557,7 +557,7 @@ npm install -g agentic-toolkit
|
|
|
557
557
|
|
|
558
558
|
1. **Check which files are loaded:**
|
|
559
559
|
```bash
|
|
560
|
-
du -sh
|
|
560
|
+
du -sh liteagents/
|
|
561
561
|
du -sh skills/
|
|
562
562
|
```
|
|
563
563
|
|
|
@@ -756,7 +756,7 @@ A: Just refresh Claude (F5). Usually no computer restart needed.
|
|
|
756
756
|
**Q: Where are files stored?**
|
|
757
757
|
A: Depends on installation method:
|
|
758
758
|
- npm: `node_modules/agentic-toolkit/`
|
|
759
|
-
- Development: `/path/to/
|
|
759
|
+
- Development: `/path/to/liteagents/`
|
|
760
760
|
|
|
761
761
|
**Q: Can I use multiple variants at once?**
|
|
762
762
|
A: No, only one variant at a time. Reinstall to switch.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Variant Configuration Guide
|
|
2
2
|
|
|
3
|
-
**Purpose:** This document explains the rationale for variant configurations and skill selection across all
|
|
3
|
+
**Purpose:** This document explains the rationale for variant configurations and skill selection across all liteagents tools (Claude, Opencode, Ampcode, Droid).
|
|
4
4
|
|
|
5
5
|
**Last Updated:** 2025-11-04
|
|
6
6
|
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
|
|
19
19
|
## Variant Philosophy
|
|
20
20
|
|
|
21
|
-
The
|
|
21
|
+
The liteagents installer offers **three variant levels** to accommodate different user needs and resource constraints:
|
|
22
22
|
|
|
23
23
|
### Design Principles
|
|
24
24
|
|
|
@@ -153,7 +153,7 @@ These advanced skills are available only in the **Pro variant**:
|
|
|
153
153
|
- All hooks
|
|
154
154
|
|
|
155
155
|
**Use Cases:**
|
|
156
|
-
- Try
|
|
156
|
+
- Try liteagents with minimal commitment
|
|
157
157
|
- Learn the agent system before full installation
|
|
158
158
|
- Limited resource environments (cloud VMs, containers)
|
|
159
159
|
- Quick setup for demonstrations
|
|
@@ -269,7 +269,7 @@ While all tools share the same variant structure and core skills, each has optim
|
|
|
269
269
|
### Choosing a Variant
|
|
270
270
|
|
|
271
271
|
**Start with Lite if:**
|
|
272
|
-
- You're evaluating
|
|
272
|
+
- You're evaluating liteagents for the first time
|
|
273
273
|
- You have limited disk space (< 50 MB available)
|
|
274
274
|
- You only need basic workflow management
|
|
275
275
|
- You want to learn the system before full installation
|
|
@@ -358,7 +358,7 @@ Skills are updated independently of agents:
|
|
|
358
358
|
|
|
359
359
|
### Variant Evolution
|
|
360
360
|
|
|
361
|
-
As
|
|
361
|
+
As liteagents evolves, variant definitions may change:
|
|
362
362
|
|
|
363
363
|
**Standard Variant Philosophy:**
|
|
364
364
|
- Will always include essential document processing (pdf, docx, xlsx, pptx)
|
package/installer/cli.js
CHANGED
|
@@ -369,7 +369,7 @@ class InteractiveInstaller {
|
|
|
369
369
|
return {
|
|
370
370
|
type: 'Missing Package Error',
|
|
371
371
|
advice: [
|
|
372
|
-
'Run: npm install -g
|
|
372
|
+
'Run: npm install -g liteagents',
|
|
373
373
|
'Check: packages directory exists'
|
|
374
374
|
],
|
|
375
375
|
technicalDetails: `Missing file or package validation failed`
|
|
@@ -418,7 +418,7 @@ class InteractiveInstaller {
|
|
|
418
418
|
type: 'Unknown Error',
|
|
419
419
|
advice: [
|
|
420
420
|
'Try running installer again',
|
|
421
|
-
'Report at: https://github.com/amrhas82/
|
|
421
|
+
'Report at: https://github.com/amrhas82/liteagents/issues'
|
|
422
422
|
],
|
|
423
423
|
technicalDetails: error.stack ? error.stack.split('\n')[1] : 'No additional details'
|
|
424
424
|
};
|
|
@@ -726,7 +726,7 @@ ${colors.bright}v2.4.0 | 11 agents + 20 commands per tool${colors.reset}
|
|
|
726
726
|
* @param {string} toolName - Display name of the tool
|
|
727
727
|
*/
|
|
728
728
|
/**
|
|
729
|
-
* Generate and save installation report to ~/.
|
|
729
|
+
* Generate and save installation report to ~/.liteagents-install.log
|
|
730
730
|
* Creates a detailed log of the installation session
|
|
731
731
|
*
|
|
732
732
|
* @param {array} successfulInstalls - Array of successful installation objects
|
|
@@ -6,11 +6,11 @@ const os = require('os');
|
|
|
6
6
|
* Report Template Generator
|
|
7
7
|
*
|
|
8
8
|
* Generates detailed installation reports with summary and per-tool details.
|
|
9
|
-
* Reports are saved to ~/.
|
|
9
|
+
* Reports are saved to ~/.liteagents-install.log after each installation.
|
|
10
10
|
*/
|
|
11
11
|
class ReportTemplate {
|
|
12
12
|
constructor() {
|
|
13
|
-
this.reportPath = path.join(os.homedir(), '.
|
|
13
|
+
this.reportPath = path.join(os.homedir(), '.liteagents-install.log');
|
|
14
14
|
}
|
|
15
15
|
|
|
16
16
|
/**
|
|
@@ -268,7 +268,7 @@ WARNINGS
|
|
|
268
268
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
269
269
|
|
|
270
270
|
For support and documentation, visit:
|
|
271
|
-
https://github.com/amrhas82/
|
|
271
|
+
https://github.com/amrhas82/liteagents
|
|
272
272
|
|
|
273
273
|
Report saved to: ${this.reportPath}
|
|
274
274
|
|
package/package.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "liteagents",
|
|
3
|
-
"version": "2.4.
|
|
3
|
+
"version": "2.4.1",
|
|
4
4
|
"description": "AI development toolkit with 11 specialized agents and 20 commands. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
7
|
-
"
|
|
8
|
-
"
|
|
7
|
+
"liteagents": "./installer/cli.js",
|
|
8
|
+
"liteag": "./cli.js"
|
|
9
9
|
},
|
|
10
10
|
"scripts": {
|
|
11
11
|
"test": "node tests/run-all-tests.js",
|
|
@@ -17,9 +17,6 @@
|
|
|
17
17
|
"validate": "node ./scripts/validate-package.js",
|
|
18
18
|
"validate-packages": "node scripts/validate-all-packages.js",
|
|
19
19
|
"prepublishOnly": "npm run clean && npm run validate",
|
|
20
|
-
"publish:npm": "npm publish --registry https://registry.npmjs.org --access public",
|
|
21
|
-
"publish:github": "npm publish --registry https://npm.pkg.github.com",
|
|
22
|
-
"publish:both": "npm run publish:npm && npm run publish:github",
|
|
23
20
|
"postinstall": "node postinstall.js"
|
|
24
21
|
},
|
|
25
22
|
"keywords": [
|
|
@@ -51,12 +48,12 @@
|
|
|
51
48
|
"license": "MIT",
|
|
52
49
|
"repository": {
|
|
53
50
|
"type": "git",
|
|
54
|
-
"url": "https://github.com/amrhas82/
|
|
51
|
+
"url": "https://github.com/amrhas82/liteagents.git"
|
|
55
52
|
},
|
|
56
53
|
"bugs": {
|
|
57
|
-
"url": "https://github.com/amrhas82/
|
|
54
|
+
"url": "https://github.com/amrhas82/liteagents/issues"
|
|
58
55
|
},
|
|
59
|
-
"homepage": "https://github.com/amrhas82/
|
|
56
|
+
"homepage": "https://github.com/amrhas82/liteagents#readme",
|
|
60
57
|
"publishConfig": {
|
|
61
58
|
"registry": "https://registry.npmjs.org",
|
|
62
59
|
"access": "public"
|
|
@@ -1,177 +0,0 @@
|
|
|
1
|
-
# Dual Publishing Setup Complete ✅
|
|
2
|
-
|
|
3
|
-
Your Agentic Kit package is now configured to publish to **both npm.js and GitHub Packages** with every update!
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## ✅ What Was Configured
|
|
8
|
-
|
|
9
|
-
### 1. Package Configuration (`package.json`)
|
|
10
|
-
- Default registry set to npm.js (easier for users)
|
|
11
|
-
- Added publishing scripts:
|
|
12
|
-
- `npm run publish:npm` - Publish to npm.js only
|
|
13
|
-
- `npm run publish:github` - Publish to GitHub Packages only
|
|
14
|
-
- `npm run publish:both` - **Publish to BOTH** (recommended)
|
|
15
|
-
|
|
16
|
-
### 2. Authentication (`.npmrc`)
|
|
17
|
-
- GitHub Packages authentication ready
|
|
18
|
-
- Uses `GITHUB_TOKEN` environment variable
|
|
19
|
-
|
|
20
|
-
### 3. Publishing Script (`publish.sh`)
|
|
21
|
-
- Automated script that validates and publishes to both registries
|
|
22
|
-
- Handles missing GitHub token gracefully
|
|
23
|
-
|
|
24
|
-
### 4. Documentation
|
|
25
|
-
- **`docs/PUBLISHING.md`** - Complete merged guide for all publishing
|
|
26
|
-
- **`docs/GITHUB_SETUP.md`** - First-time GitHub Packages setup
|
|
27
|
-
- **Deleted:** `docs/GITHUB_PACKAGES.md` (merged into PUBLISHING.md)
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## 🚀 Quick Start - Publish to Both Registries
|
|
32
|
-
|
|
33
|
-
### First Time Only: Setup GitHub Packages
|
|
34
|
-
|
|
35
|
-
1. **Create GitHub Token:**
|
|
36
|
-
- Visit: https://github.com/settings/tokens
|
|
37
|
-
- Click "Generate new token (classic)"
|
|
38
|
-
- Select scopes: `write:packages`, `read:packages`
|
|
39
|
-
- Copy token (starts with `ghp_`)
|
|
40
|
-
|
|
41
|
-
2. **Set Environment Variable:**
|
|
42
|
-
```bash
|
|
43
|
-
export GITHUB_TOKEN=ghp_your_token_here
|
|
44
|
-
|
|
45
|
-
# Make it permanent (add to ~/.bashrc or ~/.zshrc)
|
|
46
|
-
echo 'export GITHUB_TOKEN=ghp_your_token_here' >> ~/.bashrc
|
|
47
|
-
source ~/.bashrc
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
3. **Verify:**
|
|
51
|
-
```bash
|
|
52
|
-
echo $GITHUB_TOKEN # Should show your token
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
**See full setup guide:** [`docs/GITHUB_SETUP.md`](docs/GITHUB_SETUP.md)
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
59
|
-
## 📦 Publishing Workflow
|
|
60
|
-
|
|
61
|
-
### Option 1: Use the Script (Easiest)
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
cd /home/hamr/PycharmProjects/agentflow
|
|
65
|
-
./publish.sh
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
### Option 2: Use npm Scripts
|
|
69
|
-
|
|
70
|
-
```bash
|
|
71
|
-
# Publish to both registries
|
|
72
|
-
npm run publish:both
|
|
73
|
-
|
|
74
|
-
# Or publish individually
|
|
75
|
-
npm run publish:npm # npm.js only
|
|
76
|
-
npm run publish:github # GitHub Packages only
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
### Complete Release Process
|
|
80
|
-
|
|
81
|
-
```bash
|
|
82
|
-
# 1. Update version
|
|
83
|
-
./UPDATE_VERSION.sh 1.2.0
|
|
84
|
-
|
|
85
|
-
# 2. Update CHANGELOG.md
|
|
86
|
-
# (Add your release notes)
|
|
87
|
-
|
|
88
|
-
# 3. Commit and tag
|
|
89
|
-
git add .
|
|
90
|
-
git commit -m "Bump version to 1.2.0"
|
|
91
|
-
git tag v1.2.0
|
|
92
|
-
git push origin main --tags
|
|
93
|
-
|
|
94
|
-
# 4. Publish to both registries
|
|
95
|
-
npm run publish:both
|
|
96
|
-
|
|
97
|
-
# 5. Verify
|
|
98
|
-
# - npm.js: https://www.npmjs.com/package/agentflow
|
|
99
|
-
# - GitHub: https://github.com/amrhas82/agentflow/packages
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
---
|
|
103
|
-
|
|
104
|
-
## 📋 Files Modified/Created
|
|
105
|
-
|
|
106
|
-
### Modified:
|
|
107
|
-
- ✅ `package.json` - Added publish scripts, set npm.js as default
|
|
108
|
-
- ✅ `.npmrc` - GitHub Packages authentication
|
|
109
|
-
- ✅ `docs/PUBLISHING.md` - Merged and updated complete guide
|
|
110
|
-
|
|
111
|
-
### Created:
|
|
112
|
-
- ✅ `publish.sh` - Automated dual publishing script
|
|
113
|
-
- ✅ `docs/GITHUB_SETUP.md` - First-time setup guide
|
|
114
|
-
- ✅ `.gitignore` - Prevents committing sensitive/backup files
|
|
115
|
-
|
|
116
|
-
### Deleted:
|
|
117
|
-
- ✅ `docs/GITHUB_PACKAGES.md` - Merged into PUBLISHING.md
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
## 🔍 Verification After Publishing
|
|
122
|
-
|
|
123
|
-
### npm.js
|
|
124
|
-
- **Page:** https://www.npmjs.com/package/agentflow
|
|
125
|
-
- **Test:** `npx agentflow --help`
|
|
126
|
-
|
|
127
|
-
### GitHub Packages
|
|
128
|
-
- **Page:** https://github.com/amrhas82/agentflow (click "Packages" on right)
|
|
129
|
-
- **Direct:** https://github.com/amrhas82/agentflow/packages
|
|
130
|
-
|
|
131
|
-
---
|
|
132
|
-
|
|
133
|
-
## ❓ Common Questions
|
|
134
|
-
|
|
135
|
-
### Q: Do I need to publish to both every time?
|
|
136
|
-
**A:** Yes, each registry is separate. Use `npm run publish:both` to publish everywhere with one command.
|
|
137
|
-
|
|
138
|
-
### Q: What if I only want to publish to npm.js?
|
|
139
|
-
**A:** Just use `npm run publish:npm` or regular `npm publish --access public`
|
|
140
|
-
|
|
141
|
-
### Q: What if my GitHub token expires?
|
|
142
|
-
**A:** Generate a new token at https://github.com/settings/tokens and update your `GITHUB_TOKEN` variable.
|
|
143
|
-
|
|
144
|
-
### Q: Can users install from either registry?
|
|
145
|
-
**A:** Yes! npm.js is easier (no token required). GitHub Packages requires users to set up `.npmrc` with their own GitHub token.
|
|
146
|
-
|
|
147
|
-
---
|
|
148
|
-
|
|
149
|
-
## 📚 Full Documentation
|
|
150
|
-
|
|
151
|
-
- **Publishing Guide:** [`docs/PUBLISHING.md`](PUBLISHING.md)
|
|
152
|
-
- **GitHub Setup:** [`docs/GITHUB_SETUP.md`](docs/GITHUB_SETUP.md)
|
|
153
|
-
- **Version Management:** Use `./UPDATE_VERSION.sh`
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## 🎯 Next Steps
|
|
158
|
-
|
|
159
|
-
1. **Setup GitHub Token** (if not done yet)
|
|
160
|
-
- Follow: [`docs/GITHUB_SETUP.md`](docs/GITHUB_SETUP.md)
|
|
161
|
-
|
|
162
|
-
2. **Test Publishing**
|
|
163
|
-
```bash
|
|
164
|
-
npm run publish:both
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
3. **Verify Both Registries**
|
|
168
|
-
- Check npm.js and GitHub Packages pages
|
|
169
|
-
|
|
170
|
-
---
|
|
171
|
-
|
|
172
|
-
**You're all set! 🎉**
|
|
173
|
-
|
|
174
|
-
Every time you want to publish an update, just run:
|
|
175
|
-
```bash
|
|
176
|
-
npm run publish:both
|
|
177
|
-
```
|
package/docs/GITHUB_PACKAGES.md
DELETED
|
@@ -1,181 +0,0 @@
|
|
|
1
|
-
# Publishing to GitHub Packages
|
|
2
|
-
|
|
3
|
-
This guide shows how to publish `agentflow` to GitHub Packages npm registry.
|
|
4
|
-
|
|
5
|
-
## Prerequisites
|
|
6
|
-
|
|
7
|
-
- GitHub account with access to `amrhas82/agentic-kit` repository
|
|
8
|
-
- npm installed locally
|
|
9
|
-
- Git repository already pushed to GitHub
|
|
10
|
-
|
|
11
|
-
## Setup Steps
|
|
12
|
-
|
|
13
|
-
### 1. Create GitHub Personal Access Token
|
|
14
|
-
|
|
15
|
-
1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
|
|
16
|
-
- Direct link: https://github.com/settings/tokens
|
|
17
|
-
2. Click **"Generate new token"** → **"Generate new token (classic)"**
|
|
18
|
-
3. Configure token:
|
|
19
|
-
- **Note**: `Publish agentic-kit to GitHub Packages`
|
|
20
|
-
- **Expiration**: Choose your preference (90 days recommended)
|
|
21
|
-
- **Scopes**: Select these permissions:
|
|
22
|
-
- ✅ `write:packages` - Upload packages to GitHub Package Registry
|
|
23
|
-
- ✅ `read:packages` - Download packages from GitHub Package Registry
|
|
24
|
-
- ✅ `delete:packages` - Delete packages from GitHub Package Registry (optional)
|
|
25
|
-
4. Click **"Generate token"**
|
|
26
|
-
5. **IMPORTANT**: Copy the token immediately (you won't see it again)
|
|
27
|
-
|
|
28
|
-
### 2. Configure Authentication
|
|
29
|
-
|
|
30
|
-
Set your GitHub token as an environment variable:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
# On Linux/macOS (add to ~/.bashrc or ~/.zshrc for persistence)
|
|
34
|
-
export GITHUB_TOKEN=ghp_your_token_here
|
|
35
|
-
|
|
36
|
-
# On Windows (Command Prompt)
|
|
37
|
-
set GITHUB_TOKEN=ghp_your_token_here
|
|
38
|
-
|
|
39
|
-
# On Windows (PowerShell)
|
|
40
|
-
$env:GITHUB_TOKEN="ghp_your_token_here"
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
**Verify it's set:**
|
|
44
|
-
```bash
|
|
45
|
-
echo $GITHUB_TOKEN # Linux/macOS
|
|
46
|
-
echo %GITHUB_TOKEN% # Windows CMD
|
|
47
|
-
echo $env:GITHUB_TOKEN # Windows PowerShell
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### 3. Publish to GitHub Packages
|
|
51
|
-
|
|
52
|
-
```bash
|
|
53
|
-
cd /home/hamr/PycharmProjects/agentflow
|
|
54
|
-
|
|
55
|
-
# Ensure you're on the right version
|
|
56
|
-
npm version # Should show 1.1.0
|
|
57
|
-
|
|
58
|
-
# Publish to GitHub Packages
|
|
59
|
-
npm publish
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
### 4. Verify Publication
|
|
63
|
-
|
|
64
|
-
1. Go to your GitHub repository: https://github.com/amrhas82/agentflow
|
|
65
|
-
2. Click on **"Packages"** on the right sidebar
|
|
66
|
-
3. You should see `agentflow` listed
|
|
67
|
-
|
|
68
|
-
## Installing from GitHub Packages
|
|
69
|
-
|
|
70
|
-
Users can install your package from GitHub Packages:
|
|
71
|
-
|
|
72
|
-
### For Users
|
|
73
|
-
|
|
74
|
-
Create `.npmrc` in their project or home directory:
|
|
75
|
-
|
|
76
|
-
```
|
|
77
|
-
@amrhas82:registry=https://npm.pkg.github.com
|
|
78
|
-
//npm.pkg.github.com/:_authToken=THEIR_GITHUB_TOKEN
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
Then install:
|
|
82
|
-
```bash
|
|
83
|
-
npm install agentflow
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
## Publishing to Both Registries
|
|
87
|
-
|
|
88
|
-
You can publish to **both** npm registry AND GitHub Packages:
|
|
89
|
-
|
|
90
|
-
### Option 1: Publish to npm.js (public registry)
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
# Remove or comment out publishConfig in package.json
|
|
94
|
-
# Then publish
|
|
95
|
-
npm publish --registry https://registry.npmjs.org --access public
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
### Option 2: Publish to GitHub Packages
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
# Keep publishConfig in package.json pointing to GitHub
|
|
102
|
-
npm publish
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
### Option 3: Publish to Both (Recommended)
|
|
106
|
-
|
|
107
|
-
```bash
|
|
108
|
-
# 1. Publish to npm.js first
|
|
109
|
-
npm publish --registry https://registry.npmjs.org --access public
|
|
110
|
-
|
|
111
|
-
# 2. Then publish to GitHub Packages
|
|
112
|
-
npm publish --registry https://npm.pkg.github.com
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
## Updating Package.json for Dual Publishing
|
|
116
|
-
|
|
117
|
-
If you want to make npm.js the default and GitHub Packages optional:
|
|
118
|
-
|
|
119
|
-
**package.json:**
|
|
120
|
-
```json
|
|
121
|
-
{
|
|
122
|
-
"name": "agentflow",
|
|
123
|
-
"version": "1.1.0",
|
|
124
|
-
"publishConfig": {
|
|
125
|
-
"registry": "https://registry.npmjs.org",
|
|
126
|
-
"access": "public"
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
Then to publish to GitHub Packages specifically:
|
|
132
|
-
```bash
|
|
133
|
-
npm publish --registry https://npm.pkg.github.com
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
## Current Configuration
|
|
137
|
-
|
|
138
|
-
Your package is currently configured to publish to **GitHub Packages by default**.
|
|
139
|
-
|
|
140
|
-
**package.json** has:
|
|
141
|
-
```json
|
|
142
|
-
"publishConfig": {
|
|
143
|
-
"registry": "https://npm.pkg.github.com"
|
|
144
|
-
}
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
**.npmrc** contains:
|
|
148
|
-
```
|
|
149
|
-
@amrhas82:registry=https://npm.pkg.github.com
|
|
150
|
-
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
|
|
151
|
-
```
|
|
152
|
-
|
|
153
|
-
## Troubleshooting
|
|
154
|
-
|
|
155
|
-
### Error: 401 Unauthorized
|
|
156
|
-
|
|
157
|
-
- Verify your `GITHUB_TOKEN` is set correctly
|
|
158
|
-
- Ensure token has `write:packages` scope
|
|
159
|
-
- Check token hasn't expired
|
|
160
|
-
|
|
161
|
-
### Error: 404 Not Found
|
|
162
|
-
|
|
163
|
-
- Verify repository exists: https://github.com/amrhas82/agentflow
|
|
164
|
-
- Ensure package name matches repository owner: `agentflow`
|
|
165
|
-
|
|
166
|
-
### Error: 403 Forbidden
|
|
167
|
-
|
|
168
|
-
- Verify you have write access to the repository
|
|
169
|
-
- Check repository visibility settings (public/private)
|
|
170
|
-
|
|
171
|
-
### Package Not Showing Up
|
|
172
|
-
|
|
173
|
-
- Wait a few minutes (can take 5-10 minutes)
|
|
174
|
-
- Check GitHub repository → Packages tab
|
|
175
|
-
- Verify publish command succeeded without errors
|
|
176
|
-
|
|
177
|
-
## Links
|
|
178
|
-
|
|
179
|
-
- **GitHub Packages Documentation**: https://docs.github.com/en/packages
|
|
180
|
-
- **npm Registry Documentation**: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry
|
|
181
|
-
- **Package URL (after publishing)**: https://github.com/amrhas82/agentflow/packages
|