feat: initial release v1.0.0

- OpenAI-compatible API gateway for OpenCode CLI
- Support for Chat Completions and Responses API
- Streaming and reasoning control support
- Docker deployment ready
- Only Chinese documentation

Author: TiaraBasori

.dockerignore

@@ -0,0 +1,13 @@
+node_modules
+npm-debug.log
+.git
+.gitignore
+*.md
+!README.md
+config.json
+config.json.example
+tests
+.DS_Store
+*.log
+.env
+.env.*

.editorconfig

@@ -0,0 +1,28 @@
+# EditorConfig helps maintain consistent coding styles
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{js,jsx,ts,tsx,json}]
+indent_style = space
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.sh]
+indent_style = space
+indent_size = 4
+
+[Makefile]
+indent_style = tab

.env.example

@@ -0,0 +1,24 @@
+# Copy this file to .env before running docker compose.
+
+API_KEY=change-me
+OPENCODE_SERVER_PASSWORD=change-me-too
+
+# Safer default. Keep true unless you really want model tool access.
+DISABLE_TOOLS=true
+
+# Helpful when running behind OpenClaw or other clients that already manage prompts.
+OPENCODE_PROXY_PROMPT_MODE=plugin-inject
+OPENCODE_PROXY_OMIT_SYSTEM_PROMPT=true
+
+# Periodically clean proxy-owned conversation/session storage.
+OPENCODE_PROXY_AUTO_CLEANUP_CONVERSATIONS=true
+OPENCODE_PROXY_CLEANUP_INTERVAL_MS=43200000
+OPENCODE_PROXY_CLEANUP_MAX_AGE_MS=86400000
+
+# Optional overrides
+# OPENCODE_PROXY_PORT=10000
+# OPENCODE_SERVER_PORT=10001
+# OPENCODE_USE_ISOLATED_HOME=false
+# OPENCODE_PROXY_REQUEST_TIMEOUT_MS=180000
+# OPENCODE_PROXY_DEBUG=false
+# OPENCODE_ZEN_API_KEY=

.github/workflows/docker-publish.yml

@@ -0,0 +1,54 @@
+name: Publish Docker Image
+
+on:
+  push:
+    branches: ['main']
+    tags: ['v*.*.*']
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: tiarabasori/opencode2api
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=raw,value=${{ github.run_number }}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -0,0 +1,8 @@
+node_modules
+.DS_Store
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.env
+config.json

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-04-11
+
+### Added
+
+- **OpenAI-compatible API**: `/v1/models`, `/v1/chat/completions`, `/v1/responses` endpoints
+- **Streaming Support**: Full SSE streaming for Chat Completions and Responses API
+- **Model Aliases**: GPT-style model aliasing (e.g., `gpt5-nano` → `gpt-5-nano`)
+- **Docker Deployment**: Complete Docker setup with healthcheck and volume management
+- **Configuration**: Environment variables and config.json support
+- **Auto Cleanup**: Configurable automatic conversation/session storage cleanup
+
+### Changed
+
+- **Default Security**: `DISABLE_TOOLS` defaults to `true` for safer out-of-box behavior

CONTRIBUTING.md

@@ -0,0 +1,93 @@
+# Contributing to opencode2api
+
+Thank you for your interest in contributing to opencode2api!
+
+## Code of Conduct
+
+Please be respectful and professional. We follow the [Contributor Covenant](https://www.contributor-covenant.org/).
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Check if the issue already exists
+2. Create a detailed issue with:
+   - Clear title and description
+   - Steps to reproduce
+   - Environment details
+   - Relevant logs
+
+### Suggesting Features
+
+1. Open an issue with `[Feature Request]` prefix
+2. Describe the use case
+3. Propose a solution or API design
+
+### Pull Requests
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/your-feature`
+3. Make your changes
+4. Run tests: `npm test`
+5. Commit with clear messages (see Commit Style below)
+6. Push to your fork
+7. Submit a Pull Request
+
+## Commit Style
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+Types:
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation
+- `style`: Code style (formatting)
+- `refactor`: Code refactoring
+- `test`: Tests
+- `chore`: Build/ci updates
+
+Examples:
+```
+feat(api): add streaming support for Responses API
+fix(proxy): resolve memory leak in long-running sessions
+docs: update configuration documentation
+```
+
+## Development Setup
+
+```bash
+# Clone and install
+git clone https://github.com/TiaraBasori/opencode2api.git
+cd opencode2api
+npm install
+
+# Run tests
+npm test
+
+# Start locally
+npm start
+```
+
+## Testing
+
+- Unit tests: `npm run test:unit`
+- Integration tests: `npm run test:integration`
+- All tests: `npm test -- --runInBand`
+
+## Code Review Process
+
+1. All submissions require review
+2. Address feedback promptly
+3. Squash commits before merge
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](./LICENSE.md).

Dockerfile

@@ -0,0 +1,46 @@
+FROM node:lts-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    curl \
+    ca-certificates \
+    && dpkgArch="$(dpkg --print-architecture | awk -F- '{ print $NF }')" \
+    && curl -Lo /usr/local/bin/gosu "https://github.com/tianon/gosu/releases/download/1.17/gosu-$dpkgArch" \
+    && chmod +x /usr/local/bin/gosu \
+    && gosu --version \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN npm install -g opencode-ai
+
+RUN mkdir -p /home/node/.local/share/opencode \
+    && mkdir -p /home/node/.config/opencode \
+    && mkdir -p /home/node/project \
+    && chown -R node:node /home/node
+
+COPY entrypoint.sh /usr/local/bin/entrypoint.sh
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
+WORKDIR /home/node/project
+
+COPY package*.json ./
+RUN npm install --production
+
+COPY . .
+
+EXPOSE 10000 10001
+
+ENV OPENCODE_SERVER_PASSWORD=
+ENV API_KEY=
+ENV BIND_HOST=0.0.0.0
+ENV DISABLE_TOOLS=true
+ENV OPENCODE_USE_ISOLATED_HOME=false
+ENV OPENCODE_PROXY_DEBUG=false
+ENV OPENCODE_PROXY_PROMPT_MODE=standard
+ENV OPENCODE_PROXY_OMIT_SYSTEM_PROMPT=false
+ENV OPENCODE_PROXY_AUTO_CLEANUP_CONVERSATIONS=false
+ENV OPENCODE_PROXY_CLEANUP_INTERVAL_MS=43200000
+ENV OPENCODE_PROXY_CLEANUP_MAX_AGE_MS=86400000
+ENV OPENCODE_PROXY_REQUEST_TIMEOUT_MS=180000
+
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]
+CMD ["opencode", "serve", "--hostname", "0.0.0.0", "--port", "10001"]

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 opencode2api Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.