osagent 0.2.0 → 0.2.2

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.
Files changed (3) hide show
  1. package/README.md +42 -0
  2. package/cli.js +4279 -5347
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -42,6 +42,48 @@ npm run build
42
42
  npm link
43
43
  ```
44
44
 
45
+ ### Troubleshooting Installation
46
+
47
+ **Never use `sudo` with npm!** Using `sudo npm install -g` creates permission problems.
48
+
49
+ If you see permission errors:
50
+
51
+ ```bash
52
+ # Fix npm cache permissions
53
+ sudo chown -R $(whoami) ~/.npm
54
+
55
+ # If using nvm, also fix nvm directory
56
+ sudo chown -R $(whoami) ~/.nvm
57
+
58
+ # Clear npm cache
59
+ npm cache clean --force
60
+
61
+ # Now install without sudo
62
+ npm install -g osagent
63
+ ```
64
+
65
+ If updates don't take effect (old version showing):
66
+
67
+ ```bash
68
+ npm cache clean --force
69
+ npm install -g osagent@latest --force
70
+ osagent --version
71
+ ```
72
+
73
+ **Recommended: Use nvm** to avoid permission issues entirely:
74
+
75
+ ```bash
76
+ # Install nvm
77
+ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
78
+
79
+ # Restart terminal, then:
80
+ nvm install 20
81
+ nvm use 20
82
+
83
+ # Now npm never needs sudo
84
+ npm install -g osagent
85
+ ```
86
+
45
87
  ## Quick Start
46
88
 
47
89
  ### Option 1: Use with Ollama (Local - Recommended)