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
package/docs/INSTALLER_GUIDE.md
CHANGED
|
@@ -34,10 +34,10 @@ A comprehensive guide to installing and managing Agentic Kit tools using the int
|
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
36
|
# Install Agentic Kit globally
|
|
37
|
-
npm install -g
|
|
37
|
+
npm install -g liteagents
|
|
38
38
|
|
|
39
39
|
# Run the interactive installer
|
|
40
|
-
|
|
40
|
+
liteagents install
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
The installer will guide you through 4 simple steps:
|
|
@@ -53,7 +53,7 @@ The installer will guide you through 4 simple steps:
|
|
|
53
53
|
### Step 1: Launch the Installer
|
|
54
54
|
|
|
55
55
|
```bash
|
|
56
|
-
|
|
56
|
+
liteagents install
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
You'll see the welcome screen:
|
|
@@ -333,7 +333,7 @@ You can easily upgrade from Lite → Standard → Pro:
|
|
|
333
333
|
|
|
334
334
|
```bash
|
|
335
335
|
# Upgrade to a different variant
|
|
336
|
-
|
|
336
|
+
liteagents install
|
|
337
337
|
|
|
338
338
|
# Select the new variant when prompted
|
|
339
339
|
# The installer will detect existing installation and upgrade
|
|
@@ -454,11 +454,11 @@ You can install multiple tools simultaneously. Each tool is completely isolated
|
|
|
454
454
|
|
|
455
455
|
```bash
|
|
456
456
|
# Example: Install Claude and Opencode
|
|
457
|
-
|
|
457
|
+
liteagents install
|
|
458
458
|
# Select tools: 1,2
|
|
459
459
|
|
|
460
460
|
# Example: Install all tools
|
|
461
|
-
|
|
461
|
+
liteagents install
|
|
462
462
|
# Select tools: all
|
|
463
463
|
```
|
|
464
464
|
|
|
@@ -494,12 +494,12 @@ When you choose to customize paths, the installer will:
|
|
|
494
494
|
1. **Prompt for Path**:
|
|
495
495
|
```
|
|
496
496
|
Enter custom path for Claude (or press Enter for default):
|
|
497
|
-
> /opt/
|
|
497
|
+
> /opt/liteagents/claude
|
|
498
498
|
```
|
|
499
499
|
|
|
500
500
|
2. **Validate Path**:
|
|
501
501
|
```
|
|
502
|
-
Validating path: /opt/
|
|
502
|
+
Validating path: /opt/liteagents/claude
|
|
503
503
|
|
|
504
504
|
✓ Path is absolute
|
|
505
505
|
✓ Parent directory exists
|
|
@@ -515,7 +515,7 @@ Validating path: /opt/agentflow/claude
|
|
|
515
515
|
╚═══════════════════════════════════════════════╝
|
|
516
516
|
|
|
517
517
|
Tool: Claude
|
|
518
|
-
Proposed Path: /opt/
|
|
518
|
+
Proposed Path: /opt/liteagents/claude
|
|
519
519
|
Default Path: /home/user/.claude/
|
|
520
520
|
|
|
521
521
|
This is different from the default path.
|
|
@@ -561,10 +561,10 @@ The installer validates paths for safety and compatibility:
|
|
|
561
561
|
/opt/team/ai-tools/claude/
|
|
562
562
|
|
|
563
563
|
# External drive
|
|
564
|
-
/mnt/external/
|
|
564
|
+
/mnt/external/liteagents/claude/
|
|
565
565
|
|
|
566
566
|
# With tilde expansion
|
|
567
|
-
~/.config/
|
|
567
|
+
~/.config/liteagents/claude/
|
|
568
568
|
```
|
|
569
569
|
|
|
570
570
|
**Invalid Paths**:
|
|
@@ -615,7 +615,7 @@ Configure Paths:
|
|
|
615
615
|
**Goal**: Install Claude with recommended settings for general development
|
|
616
616
|
|
|
617
617
|
```bash
|
|
618
|
-
|
|
618
|
+
liteagents install
|
|
619
619
|
```
|
|
620
620
|
|
|
621
621
|
**Selections**:
|
|
@@ -634,7 +634,7 @@ agentic-kit install
|
|
|
634
634
|
**Goal**: Quick setup with minimal disk usage
|
|
635
635
|
|
|
636
636
|
```bash
|
|
637
|
-
|
|
637
|
+
liteagents install
|
|
638
638
|
```
|
|
639
639
|
|
|
640
640
|
**Selections**:
|
|
@@ -653,7 +653,7 @@ agentic-kit install
|
|
|
653
653
|
**Goal**: Install Claude and Opencode for different workflows
|
|
654
654
|
|
|
655
655
|
```bash
|
|
656
|
-
|
|
656
|
+
liteagents install
|
|
657
657
|
```
|
|
658
658
|
|
|
659
659
|
**Selections**:
|
|
@@ -672,7 +672,7 @@ agentic-kit install
|
|
|
672
672
|
**Goal**: Install to shared directory for team access
|
|
673
673
|
|
|
674
674
|
```bash
|
|
675
|
-
|
|
675
|
+
liteagents install
|
|
676
676
|
```
|
|
677
677
|
|
|
678
678
|
**Selections**:
|
|
@@ -696,7 +696,7 @@ agentic-kit install
|
|
|
696
696
|
**Goal**: Automated installation for CI/CD or scripts
|
|
697
697
|
|
|
698
698
|
```bash
|
|
699
|
-
|
|
699
|
+
liteagents install --silent --variant=standard --tools=claude --path claude=/opt/ci/claude
|
|
700
700
|
```
|
|
701
701
|
|
|
702
702
|
**Result**:
|
|
@@ -709,7 +709,7 @@ agentic-kit install --silent --variant=standard --tools=claude --path claude=/op
|
|
|
709
709
|
**Goal**: Upgrade existing Lite installation to Pro
|
|
710
710
|
|
|
711
711
|
```bash
|
|
712
|
-
|
|
712
|
+
liteagents install
|
|
713
713
|
```
|
|
714
714
|
|
|
715
715
|
**Selections**:
|
|
@@ -730,7 +730,7 @@ agentic-kit install
|
|
|
730
730
|
|
|
731
731
|
```bash
|
|
732
732
|
cd /home/user/projects/my-app
|
|
733
|
-
|
|
733
|
+
liteagents install
|
|
734
734
|
```
|
|
735
735
|
|
|
736
736
|
**Selections**:
|
|
@@ -761,7 +761,7 @@ Agentic Kit installer supports command-line flags for automation, scripting, and
|
|
|
761
761
|
Display help information:
|
|
762
762
|
|
|
763
763
|
```bash
|
|
764
|
-
|
|
764
|
+
liteagents install --help
|
|
765
765
|
```
|
|
766
766
|
|
|
767
767
|
Output:
|
|
@@ -769,7 +769,7 @@ Output:
|
|
|
769
769
|
Agentic Kit Interactive Multi-Tool Installer
|
|
770
770
|
|
|
771
771
|
Usage:
|
|
772
|
-
|
|
772
|
+
liteagents install [options]
|
|
773
773
|
|
|
774
774
|
Options:
|
|
775
775
|
--variant=<name> Specify variant (lite, standard, pro)
|
|
@@ -782,10 +782,10 @@ Options:
|
|
|
782
782
|
--help Display this help message
|
|
783
783
|
|
|
784
784
|
Examples:
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
785
|
+
liteagents install
|
|
786
|
+
liteagents install --variant=standard --tools=claude
|
|
787
|
+
liteagents install --silent --config=install.json
|
|
788
|
+
liteagents install --uninstall --tools=claude
|
|
789
789
|
```
|
|
790
790
|
|
|
791
791
|
#### `--version`
|
|
@@ -793,7 +793,7 @@ Examples:
|
|
|
793
793
|
Display version information:
|
|
794
794
|
|
|
795
795
|
```bash
|
|
796
|
-
|
|
796
|
+
liteagents install --version
|
|
797
797
|
```
|
|
798
798
|
|
|
799
799
|
Output:
|
|
@@ -811,13 +811,13 @@ Specify variant without interactive prompt:
|
|
|
811
811
|
|
|
812
812
|
```bash
|
|
813
813
|
# Install Lite variant
|
|
814
|
-
|
|
814
|
+
liteagents install --variant=lite
|
|
815
815
|
|
|
816
816
|
# Install Standard variant
|
|
817
|
-
|
|
817
|
+
liteagents install --variant=standard
|
|
818
818
|
|
|
819
819
|
# Install Pro variant
|
|
820
|
-
|
|
820
|
+
liteagents install --variant=pro
|
|
821
821
|
```
|
|
822
822
|
|
|
823
823
|
**Valid Values**: `lite`, `standard`, `pro`
|
|
@@ -828,13 +828,13 @@ Specify tools without interactive prompt:
|
|
|
828
828
|
|
|
829
829
|
```bash
|
|
830
830
|
# Install single tool
|
|
831
|
-
|
|
831
|
+
liteagents install --tools=claude
|
|
832
832
|
|
|
833
833
|
# Install multiple tools (comma-separated)
|
|
834
|
-
|
|
834
|
+
liteagents install --tools=claude,opencode
|
|
835
835
|
|
|
836
836
|
# Install all tools
|
|
837
|
-
|
|
837
|
+
liteagents install --tools=all
|
|
838
838
|
```
|
|
839
839
|
|
|
840
840
|
**Valid Values**: `claude`, `opencode`, `ampcode`, `droid`, `all`
|
|
@@ -845,7 +845,7 @@ Specify custom installation path for a specific tool:
|
|
|
845
845
|
|
|
846
846
|
```bash
|
|
847
847
|
# Single tool with custom path
|
|
848
|
-
|
|
848
|
+
liteagents install --tools=claude --path claude=/opt/ai/claude
|
|
849
849
|
|
|
850
850
|
# Note: For multiple tools with different paths, use --config file instead
|
|
851
851
|
```
|
|
@@ -860,7 +860,7 @@ agentic-kit install --tools=claude --path claude=/opt/ai/claude
|
|
|
860
860
|
Non-interactive installation (requires all parameters specified):
|
|
861
861
|
|
|
862
862
|
```bash
|
|
863
|
-
|
|
863
|
+
liteagents install --silent --variant=standard --tools=claude
|
|
864
864
|
```
|
|
865
865
|
|
|
866
866
|
**Behavior**:
|
|
@@ -879,8 +879,8 @@ agentic-kit install --silent --variant=standard --tools=claude
|
|
|
879
879
|
Auto-confirm all prompts:
|
|
880
880
|
|
|
881
881
|
```bash
|
|
882
|
-
|
|
883
|
-
|
|
882
|
+
liteagents install --yes
|
|
883
|
+
liteagents install -y
|
|
884
884
|
```
|
|
885
885
|
|
|
886
886
|
**Behavior**:
|
|
@@ -894,7 +894,7 @@ agentic-kit install -y
|
|
|
894
894
|
Load installation configuration from file:
|
|
895
895
|
|
|
896
896
|
```bash
|
|
897
|
-
|
|
897
|
+
liteagents install --config=install-config.json
|
|
898
898
|
```
|
|
899
899
|
|
|
900
900
|
**Configuration File Format** (`install-config.json`):
|
|
@@ -938,13 +938,13 @@ Uninstall specified tools:
|
|
|
938
938
|
|
|
939
939
|
```bash
|
|
940
940
|
# Uninstall single tool
|
|
941
|
-
|
|
941
|
+
liteagents install --uninstall --tools=claude
|
|
942
942
|
|
|
943
943
|
# Uninstall multiple tools
|
|
944
|
-
|
|
944
|
+
liteagents install --uninstall --tools=claude,opencode
|
|
945
945
|
|
|
946
946
|
# Uninstall all tools
|
|
947
|
-
|
|
947
|
+
liteagents install --uninstall --tools=all
|
|
948
948
|
```
|
|
949
949
|
|
|
950
950
|
**Behavior**:
|
|
@@ -955,7 +955,7 @@ agentic-kit install --uninstall --tools=all
|
|
|
955
955
|
|
|
956
956
|
**Silent Uninstall**:
|
|
957
957
|
```bash
|
|
958
|
-
|
|
958
|
+
liteagents install --uninstall --silent --tools=claude --yes
|
|
959
959
|
```
|
|
960
960
|
|
|
961
961
|
### Flag Combinations
|
|
@@ -964,16 +964,16 @@ agentic-kit install --uninstall --silent --tools=claude --yes
|
|
|
964
964
|
|
|
965
965
|
```bash
|
|
966
966
|
# Automated CI/CD installation
|
|
967
|
-
|
|
967
|
+
liteagents install --silent --variant=standard --tools=claude --path claude=/opt/ci/claude
|
|
968
968
|
|
|
969
969
|
# Quick default installation
|
|
970
|
-
|
|
970
|
+
liteagents install --yes
|
|
971
971
|
|
|
972
972
|
# Team configuration
|
|
973
|
-
|
|
973
|
+
liteagents install --config=team-config.json --yes
|
|
974
974
|
|
|
975
975
|
# Clean uninstall
|
|
976
|
-
|
|
976
|
+
liteagents install --uninstall --tools=all --yes
|
|
977
977
|
```
|
|
978
978
|
|
|
979
979
|
### Exit Codes
|
|
@@ -993,7 +993,7 @@ The installer returns the following exit codes:
|
|
|
993
993
|
```bash
|
|
994
994
|
#!/bin/bash
|
|
995
995
|
|
|
996
|
-
|
|
996
|
+
liteagents install --silent --variant=standard --tools=claude
|
|
997
997
|
|
|
998
998
|
if [ $? -eq 0 ]; then
|
|
999
999
|
echo "Installation successful"
|
|
@@ -1013,7 +1013,7 @@ fi
|
|
|
1013
1013
|
|
|
1014
1014
|
**Error Message**:
|
|
1015
1015
|
```
|
|
1016
|
-
✗ Permission denied: Cannot write to /opt/
|
|
1016
|
+
✗ Permission denied: Cannot write to /opt/liteagents/claude/
|
|
1017
1017
|
```
|
|
1018
1018
|
|
|
1019
1019
|
**Cause**: Insufficient write permissions for installation directory
|
|
@@ -1022,25 +1022,25 @@ fi
|
|
|
1022
1022
|
|
|
1023
1023
|
1. **Use default paths** (recommended):
|
|
1024
1024
|
```bash
|
|
1025
|
-
|
|
1025
|
+
liteagents install
|
|
1026
1026
|
# Select: Use defaults (N)
|
|
1027
1027
|
```
|
|
1028
1028
|
|
|
1029
1029
|
2. **Run with appropriate permissions**:
|
|
1030
1030
|
```bash
|
|
1031
|
-
sudo
|
|
1031
|
+
sudo liteagents install --tools=claude --path claude=/opt/liteagents/claude
|
|
1032
1032
|
```
|
|
1033
1033
|
|
|
1034
1034
|
3. **Choose writable location**:
|
|
1035
1035
|
```bash
|
|
1036
|
-
|
|
1037
|
-
# Customize path to: ~/
|
|
1036
|
+
liteagents install
|
|
1037
|
+
# Customize path to: ~/liteagents/claude/
|
|
1038
1038
|
```
|
|
1039
1039
|
|
|
1040
1040
|
4. **Fix directory permissions**:
|
|
1041
1041
|
```bash
|
|
1042
|
-
sudo chown -R $USER:$USER /opt/
|
|
1043
|
-
|
|
1042
|
+
sudo chown -R $USER:$USER /opt/liteagents
|
|
1043
|
+
liteagents install
|
|
1044
1044
|
```
|
|
1045
1045
|
|
|
1046
1046
|
---
|
|
@@ -1070,13 +1070,13 @@ rm -rf ~/.claude-old
|
|
|
1070
1070
|
|
|
1071
1071
|
2. **Install to different drive**:
|
|
1072
1072
|
```bash
|
|
1073
|
-
|
|
1073
|
+
liteagents install
|
|
1074
1074
|
# Customize path to external drive: /mnt/external/.claude/
|
|
1075
1075
|
```
|
|
1076
1076
|
|
|
1077
1077
|
3. **Use Lite variant**:
|
|
1078
1078
|
```bash
|
|
1079
|
-
|
|
1079
|
+
liteagents install --variant=lite
|
|
1080
1080
|
```
|
|
1081
1081
|
|
|
1082
1082
|
---
|
|
@@ -1094,14 +1094,14 @@ agentic-kit install --variant=lite
|
|
|
1094
1094
|
|
|
1095
1095
|
1. **Reinstall package**:
|
|
1096
1096
|
```bash
|
|
1097
|
-
npm uninstall -g
|
|
1097
|
+
npm uninstall -g liteagents
|
|
1098
1098
|
npm cache clean --force
|
|
1099
|
-
npm install -g
|
|
1099
|
+
npm install -g liteagents
|
|
1100
1100
|
```
|
|
1101
1101
|
|
|
1102
1102
|
2. **Verify installation**:
|
|
1103
1103
|
```bash
|
|
1104
|
-
npm list -g
|
|
1104
|
+
npm list -g liteagents
|
|
1105
1105
|
```
|
|
1106
1106
|
|
|
1107
1107
|
3. **Check Node.js version**:
|
|
@@ -1130,7 +1130,7 @@ node --version # Should be 14.0.0 or higher
|
|
|
1130
1130
|
^C
|
|
1131
1131
|
|
|
1132
1132
|
# Retry installation
|
|
1133
|
-
|
|
1133
|
+
liteagents install
|
|
1134
1134
|
```
|
|
1135
1135
|
|
|
1136
1136
|
3. **Check system resources**:
|
|
@@ -1145,7 +1145,7 @@ iostat -x 1
|
|
|
1145
1145
|
4. **Install to faster filesystem**:
|
|
1146
1146
|
```bash
|
|
1147
1147
|
# Avoid network drives, use local SSD
|
|
1148
|
-
|
|
1148
|
+
liteagents install --tools=claude --path claude=/home/user/.claude/
|
|
1149
1149
|
```
|
|
1150
1150
|
|
|
1151
1151
|
---
|
|
@@ -1163,8 +1163,8 @@ agentic-kit install --tools=claude --path claude=/home/user/.claude/
|
|
|
1163
1163
|
|
|
1164
1164
|
1. **Uninstall and reinstall**:
|
|
1165
1165
|
```bash
|
|
1166
|
-
|
|
1167
|
-
|
|
1166
|
+
liteagents install --uninstall --tools=claude
|
|
1167
|
+
liteagents install --variant=standard --tools=claude
|
|
1168
1168
|
```
|
|
1169
1169
|
|
|
1170
1170
|
2. **Check filesystem**:
|
|
@@ -1178,7 +1178,7 @@ touch ~/.claude/test-write && rm ~/.claude/test-write
|
|
|
1178
1178
|
|
|
1179
1179
|
3. **Use different path**:
|
|
1180
1180
|
```bash
|
|
1181
|
-
|
|
1181
|
+
liteagents install --tools=claude --path claude=/tmp/.claude-test/
|
|
1182
1182
|
```
|
|
1183
1183
|
|
|
1184
1184
|
---
|
|
@@ -1196,7 +1196,7 @@ Error: Cannot find module 'installer/cli.js'
|
|
|
1196
1196
|
|
|
1197
1197
|
1. **Reinstall globally**:
|
|
1198
1198
|
```bash
|
|
1199
|
-
npm install -g
|
|
1199
|
+
npm install -g liteagents
|
|
1200
1200
|
```
|
|
1201
1201
|
|
|
1202
1202
|
2. **Check npm prefix**:
|
|
@@ -1242,8 +1242,8 @@ cat ~/.claude/config.json
|
|
|
1242
1242
|
|
|
1243
1243
|
4. **Reinstall with default paths**:
|
|
1244
1244
|
```bash
|
|
1245
|
-
|
|
1246
|
-
|
|
1245
|
+
liteagents install --uninstall --tools=claude
|
|
1246
|
+
liteagents install --variant=standard --tools=claude
|
|
1247
1247
|
# Use default paths
|
|
1248
1248
|
```
|
|
1249
1249
|
|
|
@@ -1264,7 +1264,7 @@ agentic-kit install --variant=standard --tools=claude
|
|
|
1264
1264
|
|
|
1265
1265
|
2. **Disable colors** (if needed):
|
|
1266
1266
|
```bash
|
|
1267
|
-
NO_COLOR=1
|
|
1267
|
+
NO_COLOR=1 liteagents install
|
|
1268
1268
|
```
|
|
1269
1269
|
|
|
1270
1270
|
---
|
|
@@ -1275,15 +1275,15 @@ If you encounter an issue not listed here:
|
|
|
1275
1275
|
|
|
1276
1276
|
1. **Check logs**:
|
|
1277
1277
|
```bash
|
|
1278
|
-
cat ~/.
|
|
1278
|
+
cat ~/.liteagents-install.log
|
|
1279
1279
|
```
|
|
1280
1280
|
|
|
1281
1281
|
2. **File an issue**:
|
|
1282
|
-
- GitHub: https://github.com/amrhas82/
|
|
1282
|
+
- GitHub: https://github.com/amrhas82/liteagents/issues
|
|
1283
1283
|
- Include: OS, Node.js version, error message, installation log
|
|
1284
1284
|
|
|
1285
1285
|
3. **Community support**:
|
|
1286
|
-
- Discussions: https://github.com/amrhas82/
|
|
1286
|
+
- Discussions: https://github.com/amrhas82/liteagents/discussions
|
|
1287
1287
|
- Discord: [link if available]
|
|
1288
1288
|
|
|
1289
1289
|
---
|
|
@@ -1350,7 +1350,7 @@ Times vary based on system performance.
|
|
|
1350
1350
|
|
|
1351
1351
|
**A**: Yes! Use silent mode:
|
|
1352
1352
|
```bash
|
|
1353
|
-
|
|
1353
|
+
liteagents install --silent --variant=standard --tools=claude
|
|
1354
1354
|
```
|
|
1355
1355
|
|
|
1356
1356
|
#### Q: Do I need sudo/admin permissions?
|
|
@@ -1409,7 +1409,7 @@ agentic-kit install --silent --variant=standard --tools=claude
|
|
|
1409
1409
|
|
|
1410
1410
|
**A**:
|
|
1411
1411
|
```bash
|
|
1412
|
-
|
|
1412
|
+
liteagents install --uninstall --tools=claude
|
|
1413
1413
|
```
|
|
1414
1414
|
|
|
1415
1415
|
#### Q: Will uninstalling remove my settings?
|
|
@@ -1423,14 +1423,14 @@ cp ~/.claude/config.json ~/claude-config-backup.json
|
|
|
1423
1423
|
|
|
1424
1424
|
**A**: Yes:
|
|
1425
1425
|
```bash
|
|
1426
|
-
|
|
1426
|
+
liteagents install --uninstall --tools=all
|
|
1427
1427
|
```
|
|
1428
1428
|
|
|
1429
1429
|
#### Q: Does uninstall remove the installer itself?
|
|
1430
1430
|
|
|
1431
1431
|
**A**: No. To remove the installer:
|
|
1432
1432
|
```bash
|
|
1433
|
-
npm uninstall -g
|
|
1433
|
+
npm uninstall -g liteagents
|
|
1434
1434
|
```
|
|
1435
1435
|
|
|
1436
1436
|
---
|
|
@@ -1456,7 +1456,7 @@ node --version
|
|
|
1456
1456
|
|
|
1457
1457
|
**A**: Yes! Use silent mode:
|
|
1458
1458
|
```bash
|
|
1459
|
-
|
|
1459
|
+
liteagents install --silent --variant=standard --tools=claude --path claude=/opt/ci/claude
|
|
1460
1460
|
```
|
|
1461
1461
|
|
|
1462
1462
|
#### Q: Does installation require compilation?
|
|
@@ -1476,8 +1476,8 @@ agentic-kit install --silent --variant=standard --tools=claude --path claude=/op
|
|
|
1476
1476
|
**A**:
|
|
1477
1477
|
1. Check the error message
|
|
1478
1478
|
2. Review the [Troubleshooting section](#troubleshooting)
|
|
1479
|
-
3. Check logs: `cat ~/.
|
|
1480
|
-
4. Retry with: `
|
|
1479
|
+
3. Check logs: `cat ~/.liteagents-install.log`
|
|
1480
|
+
4. Retry with: `liteagents install`
|
|
1481
1481
|
5. File an issue if problem persists
|
|
1482
1482
|
|
|
1483
1483
|
#### Q: Tool can't find installed agents. Why?
|
|
@@ -1498,8 +1498,8 @@ agentic-kit install --silent --variant=standard --tools=claude --path claude=/op
|
|
|
1498
1498
|
Example Dockerfile:
|
|
1499
1499
|
```dockerfile
|
|
1500
1500
|
FROM node:18
|
|
1501
|
-
RUN npm install -g
|
|
1502
|
-
RUN
|
|
1501
|
+
RUN npm install -g liteagents
|
|
1502
|
+
RUN liteagents install --silent --variant=standard --tools=claude
|
|
1503
1503
|
```
|
|
1504
1504
|
|
|
1505
1505
|
---
|
|
@@ -1510,7 +1510,7 @@ RUN agentic-kit install --silent --variant=standard --tools=claude
|
|
|
1510
1510
|
|
|
1511
1511
|
**A**: Configuration is saved in:
|
|
1512
1512
|
- Installation manifest: `~/.claude/manifest.json` (per tool)
|
|
1513
|
-
- Global config: `~/.
|
|
1513
|
+
- Global config: `~/.liteagents-config.json`
|
|
1514
1514
|
|
|
1515
1515
|
#### Q: Can I use a configuration file?
|
|
1516
1516
|
|
|
@@ -1526,7 +1526,7 @@ RUN agentic-kit install --silent --variant=standard --tools=claude
|
|
|
1526
1526
|
|
|
1527
1527
|
Then run:
|
|
1528
1528
|
```bash
|
|
1529
|
-
|
|
1529
|
+
liteagents install --config=install-config.json
|
|
1530
1530
|
```
|
|
1531
1531
|
|
|
1532
1532
|
#### Q: How do I customize which skills are installed?
|
|
@@ -1549,8 +1549,8 @@ agentic-kit install --config=install-config.json
|
|
|
1549
1549
|
|
|
1550
1550
|
**A**: Yes:
|
|
1551
1551
|
```bash
|
|
1552
|
-
npm install -g
|
|
1553
|
-
|
|
1552
|
+
npm install -g liteagents@beta
|
|
1553
|
+
liteagents install
|
|
1554
1554
|
```
|
|
1555
1555
|
|
|
1556
1556
|
#### Q: How do I contribute new agents or skills?
|
|
@@ -1575,9 +1575,9 @@ agentic-kit install
|
|
|
1575
1575
|
Need help? Here's how to get support:
|
|
1576
1576
|
|
|
1577
1577
|
1. **Documentation**: Check this guide and related docs
|
|
1578
|
-
2. **Issues**: https://github.com/amrhas82/
|
|
1579
|
-
3. **Discussions**: https://github.com/amrhas82/
|
|
1580
|
-
4. **Email**: support@
|
|
1578
|
+
2. **Issues**: https://github.com/amrhas82/liteagents/issues
|
|
1579
|
+
3. **Discussions**: https://github.com/amrhas82/liteagents/discussions
|
|
1580
|
+
4. **Email**: support@liteagents.dev (if available)
|
|
1581
1581
|
|
|
1582
1582
|
---
|
|
1583
1583
|
|
|
@@ -193,7 +193,7 @@ Our installer adds:
|
|
|
193
193
|
|
|
194
194
|
### **Recommendation** (for future consideration)
|
|
195
195
|
1. Consider alternative installation path like `~/.claude-code` or `~/.claude/packages`
|
|
196
|
-
2. Or add namespace: `~/.claude/
|
|
196
|
+
2. Or add namespace: `~/.claude/liteagents/`
|
|
197
197
|
3. Document the shared directory usage
|
|
198
198
|
4. Add detection logic to warn if files conflict
|
|
199
199
|
5. Update PRD to clarify installation path strategy
|
package/docs/KNOWLEDGE_BASE.md
CHANGED
|
@@ -568,8 +568,8 @@ Create your own marketplace catalog:
|
|
|
568
568
|
"name": "My Custom Marketplace",
|
|
569
569
|
"plugins": [
|
|
570
570
|
{
|
|
571
|
-
"name": "
|
|
572
|
-
"source": "github:amrhas82/
|
|
571
|
+
"name": "liteagents-standard",
|
|
572
|
+
"source": "github:amrhas82/liteagents"
|
|
573
573
|
}
|
|
574
574
|
]
|
|
575
575
|
}
|
|
@@ -580,8 +580,8 @@ Create your own marketplace catalog:
|
|
|
580
580
|
Clone and link for development:
|
|
581
581
|
|
|
582
582
|
```bash
|
|
583
|
-
git clone https://github.com/amrhas82/
|
|
584
|
-
cd
|
|
583
|
+
git clone https://github.com/amrhas82/liteagents.git
|
|
584
|
+
cd liteagents
|
|
585
585
|
npm link
|
|
586
586
|
```
|
|
587
587
|
|
|
@@ -694,7 +694,7 @@ A: Yes! The `session-start` hook loads skills automatically.
|
|
|
694
694
|
A: Yes! Add markdown files to `agents/` and update the manifest.
|
|
695
695
|
|
|
696
696
|
**Q: How do I update to the latest version?**
|
|
697
|
-
A: `npm update
|
|
697
|
+
A: `npm update liteagents` or reinstall via Claude Code.
|
|
698
698
|
|
|
699
699
|
**Q: Is there a Pro trial?**
|
|
700
700
|
A: All variants are free and open-source. Install Pro to try it.
|
|
@@ -709,9 +709,9 @@ A: Agents are AI assistants with roles. Skills are executable tools agents can u
|
|
|
709
709
|
|
|
710
710
|
## Resources
|
|
711
711
|
|
|
712
|
-
- **GitHub:** https://github.com/amrhas82/
|
|
713
|
-
- **npm:** https://www.npmjs.com/package/
|
|
714
|
-
- **Issues:** https://github.com/amrhas82/
|
|
712
|
+
- **GitHub:** https://github.com/amrhas82/liteagents
|
|
713
|
+
- **npm:** https://www.npmjs.com/package/liteagents
|
|
714
|
+
- **Issues:** https://github.com/amrhas82/liteagents/issues
|
|
715
715
|
- **Detailed Docs:**
|
|
716
716
|
- [AGENTS.md](AGENTS.md) - Complete agent directory
|
|
717
717
|
- [SKILLS.md](SKILLS.md) - Complete skill reference
|
package/docs/MIGRATION.md
CHANGED
|
@@ -304,7 +304,7 @@ rm -rf ~/.claude
|
|
|
304
304
|
cp -r ~/.claude.backup ~/.claude
|
|
305
305
|
|
|
306
306
|
# Reinstall old version
|
|
307
|
-
npm install -g
|
|
307
|
+
npm install -g liteagents@1.1.0
|
|
308
308
|
```
|
|
309
309
|
|
|
310
310
|
## Migration Checklist
|
|
@@ -365,7 +365,7 @@ After migrating, verify:
|
|
|
365
365
|
If you encounter issues during migration:
|
|
366
366
|
|
|
367
367
|
1. **Check Documentation**: Review this guide and INSTALLER_GUIDE.md
|
|
368
|
-
2. **GitHub Issues**: https://github.com/amrhas82/
|
|
368
|
+
2. **GitHub Issues**: https://github.com/amrhas82/liteagents/issues
|
|
369
369
|
3. **Debug Mode**: Run with `DEBUG=* node installer/cli.js`
|
|
370
370
|
4. **Manual Migration**: Follow manual migration steps above
|
|
371
371
|
|
package/docs/PACKAGE_BASELINE.md
CHANGED
|
@@ -554,4 +554,4 @@ When creating packages for other tools (Opencode, Ampcode, Droid):
|
|
|
554
554
|
- Comprehensive document processing
|
|
555
555
|
- Developer-focused skills
|
|
556
556
|
|
|
557
|
-
This baseline serves as the foundation for creating consistent, high-quality packages across all
|
|
557
|
+
This baseline serves as the foundation for creating consistent, high-quality packages across all liteagents tools.
|
package/docs/PASS_INTEGRATION.md
CHANGED
package/docs/PASS_QUICK_START.md
CHANGED
|
@@ -83,8 +83,8 @@ git push origin main --tags
|
|
|
83
83
|
./publish.sh
|
|
84
84
|
|
|
85
85
|
# 5. Verify
|
|
86
|
-
# - npm.js: https://www.npmjs.com/package/
|
|
87
|
-
# - GitHub: https://github.com/amrhas82/
|
|
86
|
+
# - npm.js: https://www.npmjs.com/package/liteagents
|
|
87
|
+
# - GitHub: https://github.com/amrhas82/liteagents/packages
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
---
|