@jive-ai/cli 0.0.31 → 0.0.33

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 ADDED
@@ -0,0 +1,109 @@
1
+ # Jive CLI
2
+
3
+ The official CLI for Jive AI - autonomous development workflows powered by Claude.
4
+
5
+ ## Installation
6
+
7
+ ### npm
8
+
9
+ ```bash
10
+ npm install -g @jive-ai/cli
11
+ ```
12
+
13
+ ### Docker
14
+
15
+ ```bash
16
+ docker pull jiveai/task:latest
17
+ ```
18
+
19
+ ## Configuration
20
+
21
+ ### Environment Variables
22
+
23
+ The CLI can be configured using environment variables:
24
+
25
+ - `JIVE_TASK_IDLE_TIMEOUT` - Minutes of idle time before a task automatically terminates (default: 5). Tasks are ephemeral and will gracefully shutdown after this period of inactivity, freeing up runner capacity. Session data is preserved for resume.
26
+ - Development: `JIVE_TASK_IDLE_TIMEOUT=10` (10 minutes - more forgiving)
27
+ - Production: `JIVE_TASK_IDLE_TIMEOUT=5` (5 minutes - default)
28
+ - CI/CD: `JIVE_TASK_IDLE_TIMEOUT=30` (30 minutes - long builds)
29
+
30
+ - `JIVE_API_KEY` - Your Jive API authentication key (required for task runners)
31
+ - `JIVE_TEAM_ID` - The team ID to run tasks for (required for task runners)
32
+ - `JIVE_API_URL` - API endpoint (defaults to production)
33
+ - `JIVE_WS_URL` - WebSocket endpoint (defaults to production)
34
+ - `JIVE_LOG_FILE` - MCP server log path (defaults to `/tmp/jive-mcp.log`)
35
+
36
+ ## Docker Image
37
+
38
+ The docker image is used for each task process container. Whenever you spin up a new task in Jive,
39
+ it will start a new container with this image. You can specify your own custom image in the project settings
40
+ as long as the same entrypoint script is provided. The task runner relies on it.
41
+
42
+ ### Building Your Own Images
43
+
44
+ You can extend the Jive task runner image to add custom tools or dependencies:
45
+
46
+ ```dockerfile
47
+ FROM jiveai/task:latest
48
+
49
+ # Add your custom dependencies
50
+ RUN apk add --no-cache python3 py3-pip
51
+
52
+ # Install additional tools
53
+ RUN pip install --break-system-packages black ruff
54
+ ```
55
+
56
+ ## Publishing the Docker Image (Maintainers)
57
+
58
+ ### One-Time Setup
59
+
60
+ 1. Login to Docker Hub:
61
+ ```bash
62
+ docker login
63
+ ```
64
+
65
+ 2. Create a buildx builder for multi-platform builds:
66
+ ```bash
67
+ docker buildx create --name mybuilder --use
68
+ docker buildx inspect --bootstrap
69
+ ```
70
+
71
+ ### Publishing a New Version
72
+
73
+ After publishing a new version to npm, publish the corresponding Docker image:
74
+
75
+ ```bash
76
+ cd cli
77
+ npm run docker:publish
78
+ ```
79
+
80
+ This will:
81
+ - Build for both `linux/amd64` and `linux/arm64` platforms
82
+ - Tag with both `latest` and the current package version (e.g., `0.0.31`)
83
+ - Push both tags to Docker Hub
84
+
85
+ The image pulls the CLI from npm (using the `@jive-ai/cli` package), so make sure you've published to npm first.
86
+
87
+ ### Manual Steps
88
+
89
+ If you need more control:
90
+
91
+ ```bash
92
+ # Build only (no push)
93
+ npm run docker:build:public
94
+
95
+ # Push to Docker Hub
96
+ npm run docker:push
97
+ ```
98
+
99
+ ## Development
100
+
101
+ ### Local Development with Docker
102
+
103
+ To test the Docker image with your local code changes:
104
+
105
+ ```bash
106
+ npm run docker:build:local
107
+ ```
108
+
109
+ This builds an image using the local CLI tarball instead of pulling from npm.
@@ -0,0 +1,3 @@
1
+ import { A as getProjectConfig, D as clearCredentials, F as saveCredentials, I as saveProjectConfig, L as updateCredentials, M as isProjectInitialized, N as requireAuth, O as getActiveTeamId, P as requireProjectConfig, R as updateProjectConfig, j as getTasksConfigSync, k as getCredentials } from "./index.mjs";
2
+
3
+ export { getCredentials };
@@ -0,0 +1,3 @@
1
+ import { C as queries, S as mutations, b as cliMutations, x as cliQueries, y as getGraphQLClient } from "./index.mjs";
2
+
3
+ export { getGraphQLClient };