heyatlas 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/README.md +71 -0
- package/dist/cli.js +16280 -0
- package/package.json +51 -0
package/README.md
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# HeyAtlas CLI
|
|
2
|
+
|
|
3
|
+
A lightweight CLI tool to connect local AI agents to HeyAtlas cloud infrastructure for voice-powered interactions.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g heyatlas
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Or with yarn:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
yarn global add heyatlas
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Quick Start
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
heyatlas login
|
|
21
|
+
heyatlas connect
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Features
|
|
25
|
+
|
|
26
|
+
- 🔒 **Local-first security** - Your computer initiates the connection; no incoming ports needed
|
|
27
|
+
- ⚡ **Real-time voice interface** - WebSocket-based communication with low-latency voice interaction
|
|
28
|
+
- 🛠️ **Agent agnostic** - Works with any CLI-based local agent (OpenCode, Goose, etc.)
|
|
29
|
+
- 🔑 **Bring Your Own Keys** - Manage your own API credentials securely
|
|
30
|
+
|
|
31
|
+
## Configuration
|
|
32
|
+
|
|
33
|
+
The CLI stores configuration in `~/.heyatlas/` including:
|
|
34
|
+
- Authentication credentials
|
|
35
|
+
- Agent connection settings
|
|
36
|
+
|
|
37
|
+
Set `HEYATLAS_API` environment variable to use a custom API endpoint:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
export HEYATLAS_API=https://custom.heyatlas.app
|
|
41
|
+
heyatlas login
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Environment Variables
|
|
45
|
+
|
|
46
|
+
- `HEYATLAS_API` - Override the default API endpoint (default: https://www.heyatlas.app)
|
|
47
|
+
- `DEBUG` - Enable debug logging
|
|
48
|
+
|
|
49
|
+
## Development
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# Install dependencies
|
|
53
|
+
bun install
|
|
54
|
+
|
|
55
|
+
# Start dev server
|
|
56
|
+
bun run dev
|
|
57
|
+
|
|
58
|
+
# Build
|
|
59
|
+
bun run build
|
|
60
|
+
|
|
61
|
+
# Start
|
|
62
|
+
bun run start
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## License
|
|
66
|
+
|
|
67
|
+
MIT - See LICENSE file for details
|
|
68
|
+
|
|
69
|
+
## Support
|
|
70
|
+
|
|
71
|
+
For issues, questions, or contributions, visit the [HeyAtlas GitHub repository](https://github.com/yourusername/heyatlas)
|