opencode-cloud-core 0.1.2

Core library for opencode-cloud - config management, singleton enforcement, and shared utilities
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

# opencode-cloud

[![CI](https://github.com/pRizz/opencode-cloud/actions/workflows/ci.yml/badge.svg)](https://github.com/pRizz/opencode-cloud/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A production-ready toolkit for deploying [opencode](https://github.com/anomalyco/opencode) as a persistent cloud service.

## Features

- Cross-platform CLI (`opencode-cloud` / `occ`)
- Docker container management
- Service lifecycle commands (start, stop, status, logs)
- Platform service integration (systemd/launchd)
- XDG-compliant configuration
- Singleton enforcement (one instance per host)

## Requirements

### For npm installation

- **Node.js 20+**
- **Rust 1.82+** (for compiling native bindings)
  - Install via [rustup](https://rustup.rs): `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`

### For cargo installation

- **Rust 1.82+**

## Installation

### Via npm (compiles from source)

```bash
npx opencode-cloud --version
```

Or install globally:

```bash
npm install -g opencode-cloud
occ --version
```

### Via cargo

```bash
cargo install opencode-cloud
opencode-cloud --version
```

### From source

```bash
git clone https://github.com/pRizz/opencode-cloud.git
cd opencode-cloud
just build
cargo run -p opencode-cloud -- --version
```

## Usage

```bash
# Show version
occ --version

# View configuration
occ config show

# More commands coming in future releases:
# occ start    - Start the service
# occ stop     - Stop the service
# occ status   - Check service status
# occ logs     - View service logs
```

## Configuration

Configuration is stored at:
- Linux/macOS: `~/.config/opencode-cloud/config.json`

Data (PID files, etc.) is stored at:
- Linux/macOS: `~/.local/share/opencode-cloud/`

## Development

```bash
# Install dependencies
pnpm install

# Build everything
just build

# Run tests
just test

# Format and lint
just fmt
just lint
```

## Architecture

This is a monorepo with:
- `packages/core` - Rust core library with NAPI-RS bindings
- `packages/cli-rust` - Rust CLI binary
- `packages/cli-node` - Node.js CLI wrapper (calls into core via NAPI)

The npm package compiles the Rust core on install (no prebuilt binaries).

## License

MIT