zhongwei/gh-breakds-claude-bds-bds-dev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
Zhongwei Li
2025-11-29 18:02:30 +08:00
commit e03e44248d
17 changed files with 785 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
.claude-plugin/plugin.json Normal file
View File

@@ -0,0 +1,14 @@
{
"name": "bds-dev",
"description": "Provide tools and skills for daily development",
"version": "1.0.1",
"author": {
"name": "Break Yang"
},
"skills": [
"./skills"
],
"commands": [
"./commands"
]
}

3
README.md Normal file
View File

@@ -0,0 +1,3 @@
# bds-dev
Provide tools and skills for daily development

20
commands/prime.md Normal file
View File

@@ -0,0 +1,20 @@
# Prime the context by analyzing the project structure
Use the command `lsd --tree` to get an overview of the project's code structure. In addition,
- Read the `README.md` if exist
- Read the `flake.nix` if exist
- Files which you think are important
- For python project, read `pyproject.toml` if exist
- For javascript and typescript project, read `package.json` if exist
- For rust project, read `Cargo.toml` if exist
- For c++ project read `CMakeLists.txt` and use it as the entrypoint to understand the project structure
## Goal
You should be able to tell the following
- The structure of the project
- What problem does this project solve?
- What are the major programming languages used in this project?
- What is the entrypoint of this project?

36
commands/python-ready.md Normal file
View File

@@ -0,0 +1,36 @@
# Prepare CLAUDE CODE with Python-Specific Context
## Task
Read the project’s `CLAUDE.md`. Ensure all Python rules below are present. If partially present, reorganize and edit `CLAUDE.md` so all rules are included exactly and unambiguously.
## Python Rules
### Environment
1. Manage the dev environment with `flake.nix` only.
2. Assume `nix develop` is active.
3. Do not use `pip`, `uv`, or `poetry`.
4. Run programs as modules: `python -m package.module`.
### Library Preferences
1. Use builtin **unittest**.
- Discover all tests: `python -m unittest discover`
- Run verbose/specific: `python -m unittest -v path/to/test_file.py`
2. Use **pydantic v2** for schemas and domain models.
3. Use **PyTorch** and **JAX** for ML models.
4. Use **loguru** for logging.
5. Use **click** for CLI/arg parsing.
6. Prefer **pathlib** over `os.path`.
7. Use explicit `StrEnum` / `IntEnum` for enums.
### Code Style
1. **Use absolute imports**; do not use relative imports (e.g., avoid `from .x import y`).
2. Prefer specific imports (e.g., `from pydantic import BaseModel`).
3. **Use type hints everywhere**:
- Annotate all function parameters and return types.
- Use builtin generics (`list`, `dict`, `tuple`) instead of `typing.List`, etc.
- For optionals, use `MyType | None` instead of `Optional[MyType]`.
### Documentation
1. **Write docstrings for all public modules, functions, classes, methods**, and public-facing APIs. PEP 8 and PEP 257 recommend docstrings for all public elements.
2. In docstrings:
- **Do not include types in the `Args:` section**, type hints in signatures cover that.

39
commands/web-ready.md Normal file
View File

@@ -0,0 +1,39 @@
# Prepare CLAUDE CODE with Web Development Context
## Task
Read the project’s `CLAUDE.md`. Ensure all web development rules below are present. If some are missing or partially present, reorganize and update `CLAUDE.md` so every rule is included clearly and unambiguously.
## Web Development Rules
### Language & Syntax
1. Use **TypeScript** only (no plain JavaScript).
2. Omit unnecessary semicolons—that is, do not add semicolons at statement ends unless required.
3. Prefer **arrow functions** (`const f = () => ...`) for concise, inline code and callbacks. Use **function declarations** for named or top-level functions where `this` or hoisting matters.
### Typing & Imports
1. Always use **explicit types**, especially for function parameters and return values. Annotate returns and arguments when it improves readability.
2. Avoid `any`. Use `unknown` or properly constrained generics instead—`unknown` forces safe type narrowing.
3. Organize imports in this order:
* `react`
* third-party libraries
* local modules
4. Support **absolute imports** in `.ts`/`.tsx` files, e.g.:
```ts
import '@/components/MarkdownPreviewPanel'
```
resolves to `src/components/MarkdownPreviewPanel.tsx`.
### React & Components
- In React components, always **destructure `props`** directly in function parameters.
- Keep `README.md` updated with essential information about React components—especially view or UI-related ones.
### Documentation
- Document important functions, classes, and React components with inline docstrings or comments for clarity and maintainability.

97
plugin.lock.json Normal file
View File

@@ -0,0 +1,97 @@
{
"$schema": "internal://schemas/plugin.lock.v1.json",
"pluginId": "gh:breakds/claude.bds:bds-dev",
"normalized": {
"repo": null,
"ref": "refs/tags/v20251128.0",
"commit": "c15718f1fde63a61069d806bad838211c65240a4",
"treeHash": "7472eb9f12a9722350b008781cd7d95c726ddb1da6506fe1147b0ee1e5f889fe",
"generatedAt": "2025-11-28T10:14:24.453360Z",
"toolVersion": "publish_plugins.py@0.2.0"
},
"origin": {
"remote": "git@github.com:zhongweili/42plugin-data.git",
"branch": "master",
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
},
"manifest": {
"name": "bds-dev",
"description": "Provide tools and skills for daily development",
"version": "1.0.1"
},
"content": {
"files": [
{
"path": "README.md",
"sha256": "52056a529c8af6260dfb803c32c8b1ad249b4c683598cd245273b7b38c71b3b7"
},
{
"path": ".claude-plugin/plugin.json",
"sha256": "762a463cb60c13a18077e1c0a60a2369f78200b2dc675b7d6422c82f16777e45"
},
{
"path": "commands/prime.md",
"sha256": "cc8d65d6f35b0c8c8e57eeeeddfcb9aa867d88aead3ddc77409b4dd79827954e"
},
{
"path": "commands/python-ready.md",
"sha256": "5ea798c5898e862877aa98217aa2898185b8e5cb32aab154eb65fac4458a770a"
},
{
"path": "commands/web-ready.md",
"sha256": "3b9b91b836666ed12efb16e56b6ea8b357e07d9fc5ab0de2676d051e1a0c9df8"
},
{
"path": "skills/nix-packaging/SKILL.md",
"sha256": "150c14e2ff30588b0eb8661ee813a8fece458ebc8a62d37a82857712ba7990d8"
},
{
"path": "skills/nix-packaging/python/python.md",
"sha256": "25917f62f71bbb07889741c85c4f1f776b81bafbe6eed095352caea41ddefdfd"
},
{
"path": "skills/nix-packaging/python/swanboard/package.nix",
"sha256": "476c8e48476bcec8c0d826e9e1e7abb50bd142ce87c6ceb185787a1758cef538"
},
{
"path": "skills/nix-packaging/python/tantivy/package.nix",
"sha256": "decc51ddd440af8a28ed6fa39ef0ed4c890887f7302dfc84c2d8b7fe2dec93c6"
},
{
"path": "skills/nix-packaging/python/darts/package.nix",
"sha256": "7e89e0816aa082f0142185be75dcd5a1008222a51573c8e7a02e2dbf700132d1"
},
{
"path": "skills/nix-packaging/python/agno/package.nix",
"sha256": "8d591d811c69e6bda69e39bc495b901add11c54de979a4d1be544d3574a3fd62"
},
{
"path": "skills/nix-packaging/python/tyro/package.nix",
"sha256": "4476f22a69d79b0b116a8efde7773d80f0f1cc9a91d52ba22df55165d60ce664"
},
{
"path": "skills/nix-packaging/js/js.md",
"sha256": "4d46fa98bd64811322cf6478934e255713e47fb4f3a92bd7c9bf47743ec17617"
},
{
"path": "skills/nix-packaging/js/claude-code/package.nix",
"sha256": "3e4fd254f21c17016e27a4e30f16e7d7245a11a0a617524ef995a6f464758143"
},
{
"path": "skills/nix-packaging/rust/rust.md",
"sha256": "673e7d1fa3f6c1cd05b326997410d3f2c8636f58473723e35e38e20502544718"
},
{
"path": "skills/nix-packaging/rust/codex/package.nix",
"sha256": "9c46c61b70554a2152946fe152c5265024a4f8bed3229ff1a234c79091b33b44"
}
],
"dirSha256": "7472eb9f12a9722350b008781cd7d95c726ddb1da6506fe1147b0ee1e5f889fe"
},
"security": {
"scannedAt": null,
"scannerVersion": null,
"flags": []
}
}

40
skills/nix-packaging/SKILL.md Normal file
View File

@@ -0,0 +1,40 @@
---
name: Nix Packaging
description: Package new software or update existing packages using Nix
---
# Overview
Create new Nix packages or update existing ones, with language-specific examples and guidance.
## Workflow: Creating a New Package
1. Identify the software source: internal to this repo or external (e.g., a GitHub repository).
2. Determine the programming language(s) used.
3. Analyze the software structure (build system, dependencies, configuration files).
4. Create the package following language-specific guidance below.
5. Optionally, integrate the package into the current project (e.g., add to overlay and expose via `packages` in `flake.nix`).
6. Test iteratively: run `nix build .#<package-name>`, read errors, fix issues, and rebuild until successful.
## Workflow: Updating an Existing Package
Typically, update the `version` and source fetching attributes (e.g., `fetchFromGitHub`). The `hash` field must also be updated using one of these methods:
**Method 1: Calculate the new hash directly**
```bash
# Get the hash
nix-prefetch-url --type sha256 --unpack https://github.com/owner/repo/archive/refs/tags/v<NEW_VERSION>.tar.gz
# Convert to SRI format
nix hash convert --hash-algo sha256 <old-hash>
```
**Method 2: Let Nix tell you the hash**
Set `hash = "";` and run the build. The error message will display the correct hash.
For language-specific update steps, see the references below.
# Language-Specific Packaging Skills
- [Python](./python/python.md) - Packaging Python modules
- [Rust](./rust/rust.md) - Packaging Rust applications
- [JavaScript/TypeScript](./js/js.md) - Packaging npm applications

52
skills/nix-packaging/js/claude-code/package.nix Normal file
View File

@@ -0,0 +1,52 @@
{
lib,
buildNpmPackage,
fetchzip,
nodejs_20,
}:
buildNpmPackage rec {
pname = "claude-code";
version = "2.0.21";
nodejs = nodejs_20; # required for sandboxed Nix builds on Darwin
src = fetchzip {
url = "https://registry.npmjs.org/@anthropic-ai/claude-code/-/claude-code-${version}.tgz";
hash = "sha256-sX9btcy9uEHloAQNvCJFhwh0U/W14NWz2FjkdLXm1Q0=";
};
npmDepsHash = "sha256-LBc1M3FwWg6SP+p7GQ00LQfiYyhmU1OzsohDu6rukjA=";
postPatch = ''
cp ${./package-lock.json} package-lock.json
'';
dontNpmBuild = true;
AUTHORIZED = "1";
# `claude-code` tries to auto-update by default, this disables that functionality.
# https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview#environment-variables
# The DEV=true env var causes claude to crash with `TypeError: window.WebSocket is not a constructor`
postInstall = ''
wrapProgram $out/bin/claude \
--set DISABLE_AUTOUPDATER 1 \
--unset DEV
'';
passthru.updateScript = ./update.sh;
meta = {
description = "Agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster";
homepage = "https://github.com/anthropics/claude-code";
downloadPage = "https://www.npmjs.com/package/@anthropic-ai/claude-code";
license = lib.licenses.unfree;
maintainers = with lib.maintainers; [
malo
markus1189
omarjatoi
];
mainProgram = "claude";
};
}

102
skills/nix-packaging/js/js.md Normal file
View File

@@ -0,0 +1,102 @@
# Package a JavaScript/TypeScript Application with Nix (npm)
Packaging an npm application (`buildNpmPackage`) involves determining the package name, version, and dependencies. The package must be available on the npm registry.
## Normal npm Package
See the example: [claude-code](./claude-code/package.nix)
Key components:
- **Source**: Fetch from npm registry using `fetchzip` with URL pattern:
```nix
url = "https://registry.npmjs.org/@scope/package-name/-/package-name-${version}.tgz";
```
For non-scoped packages, omit the `@scope/` part.
- **Dependencies**: Set `npmDepsHash` (see update workflow below for obtaining the hash)
- **package-lock.json**: Use `postPatch` to copy a local `package-lock.json`:
```nix
postPatch = ''
cp ${./package-lock.json} package-lock.json
'';
```
- **Build control**: Use `dontNpmBuild = true;` if the package doesn't require a build step (already built on npm registry)
## Updating an Existing npm Package
Besides the general update steps, also update npm-specific fields:
1. **Update package-lock.json**: Generate a new lock file for the target version:
```bash
# Find the latest version (or specific version)
npm i --package-lock-only @anthropic-ai/claude-code@"$version"
# Remove package.json (not needed for Nix packaging)
rm -f package.json
```
**Note**: If `npm` is not installed, use `nix-shell` to run it:
```bash
nix-shell -p nodejs --run "npm i --package-lock-only @anthropic-ai/claude-code@\"$version\""
rm -f package.json
```
Copy the generated `package-lock.json` to your package directory.
2. **Update hashes**: Both `hash` (source) and `npmDepsHash` need updating.
**Method 1: Let Nix tell you**
- Set `hash = "";` and run `nix build`. Copy the correct hash from the error message.
- Set `npmDepsHash = "";` and run `nix build`. Copy the correct hash from the error message.
**Method 2: Calculate directly**
```bash
# For source hash
nix-prefetch-url --type sha256 --unpack https://registry.npmjs.org/@scope/package/-/package-${version}.tgz
nix hash convert --hash-algo sha256 <old-hash>
```
3. **Check for breaking changes**: New versions may:
- Change build requirements (update `dontNpmBuild` or add build dependencies)
- Require different Node.js versions (update `nodejs` attribute, e.g., `nodejs_20`)
- Add new environment variables or runtime requirements
## Common Patterns
### Specify Node.js Version
For compatibility, especially on Darwin with sandboxed builds:
```nix
buildNpmPackage rec {
nodejs = nodejs_20;
# ...
}
```
### Disable Auto-Build
If the package is pre-built on the npm registry:
```nix
dontNpmBuild = true;
```
### Set Environment Variables
Use `postInstall` to wrap the binary with required environment variables:
```nix
postInstall = ''
wrapProgram $out/bin/your-binary \
--set ENV_VAR value \
--unset UNWANTED_VAR
'';
```
### Handle Optional Dependencies
npm packages often have platform-specific optional dependencies (like Sharp's native bindings). These are automatically handled by `buildNpmPackage` based on the `package-lock.json`.

76
skills/nix-packaging/python/agno/package.nix Normal file
View File

@@ -0,0 +1,76 @@
{
lib,
buildPythonPackage,
fetchFromGitHub,
setuptools,
docstring-parser,
gitpython,
httpx,
pydantic-settings,
pydantic,
python-dotenv,
python-multipart,
pyyaml,
rich,
tomli,
typer,
typing-extensions,
# optional
tantivy,
pylance,
lancedb,
qdrant-client,
unstructured,
markdown,
aiofiles,
}:
buildPythonPackage rec {
pname = "agno";
version = "1.7.11";
pyproject = true;
src = fetchFromGitHub {
owner = "agno-agi";
repo = "agno";
rev = "v${version}";
hash = "sha256-9oO4qyYCgMnC1jtFr39Y76t/5/ybUGIhECP+PLhm92s=";
};
sourceRoot = "${src.name}/libs/agno";
build-system = [ setuptools ];
dependencies = [
docstring-parser
gitpython
httpx
pydantic-settings
pydantic
python-dotenv
python-multipart
pyyaml
rich
tomli
typer
typing-extensions
];
optional-dependencies = {
lancedb = [ lancedb tantivy ];
pylance = [ pylance ]; # Useful for lancedb "hybrid" search
qdrant = [ qdrant-client ];
markdown = [ unstructured markdown aiofiles ];
};
pythonImportsCheck = [ "agno" ];
meta = {
description = "Full-stack framework for building Multi-Agent Systems with memory, knowledge and reasoning";
homepage = "https://github.com/agno-agi/agno";
license = lib.licenses.mpl20;
maintainers = with lib.maintainers; [ ];
mainProgram = "agno";
platforms = lib.platforms.all;
};
}

61
skills/nix-packaging/python/darts/package.nix Normal file
View File

@@ -0,0 +1,61 @@
{ lib, buildPythonPackage, fetchFromGitHub, pythonRelaxDepsHook, setuptools
, holidays, joblib, matplotlib, nfoursid, numpy, pandas, pmdarima, pyod
, requests, scikit-learn, scipy, shap
# , statsforecast
, statsmodels, tbats, tqdm, typing-extensions, xarray, xgboost
, pytorch-lightning }:
buildPythonPackage rec {
pname = "darts";
version = "0.31.0";
format = "pyproject";
src = fetchFromGitHub {
owner = "unit8co";
repo = pname;
rev = version;
hash = "sha256-piSYRJIFr3RQTt/idfTRrqx/dD794He4d2F9flBJv7Q=";
};
nativeBuildInputs = [ pythonRelaxDepsHook ];
buildInputs = [ setuptools ];
propagatedBuildInputs = [
holidays
joblib
matplotlib
nfoursid
numpy
pandas
pmdarima
pyod
requests
scikit-learn
scipy
shap
# statsforecast
statsmodels
tbats
tqdm
typing-extensions
xarray
xgboost
pytorch-lightning
];
pythonRelaxDeps = [ "pmdarima" ];
pythonRemoveDeps = [ "statsforecast" ];
pythonImportsCheck = [ "darts" ];
meta = with lib; {
description = ''
A python library for user-friendly forecasting and anomaly detection on time series
'';
homepage = "https://unit8co.github.io/darts/";
license = licenses.asl20;
maintainers = with maintainers; [ breakds ];
};
}

47
skills/nix-packaging/python/python.md Normal file
View File

@@ -0,0 +1,47 @@
# Package a Python Module with Nix
Packaging a Python module (`buildPythonPackage`) involves determining the source, dependencies, and build system, typically from `pyproject.toml`. Ensure all dependencies are already packaged before referencing them.
More complex cases require special handling. Below are examples for different scenarios.
## Normal Python Module
See the simple example: [tyro](./tyro/package.nix)
## Customize Build System and Disable Tests
Some Python modules require additional build tools, or have tests that cannot run in the Nix sandbox. See [Swanboard](./swanboard/package.nix) for an example.
## Customize Source Root and Optional Dependencies
See [agno](./agno/package.nix) for examples of:
- Using `sourceRoot` when the Python module's root differs from the project root (specify the relative path).
- Handling optional dependencies: include them in `optional-dependencies` when available, or safely omit them if not yet packaged.
## Rust-Backed Python Module
For Python packages implemented in Rust with Python bindings, use `rustPlatform` as a helper. See [tantivy](./tantivy/package.nix) for an example.
## Relax or Remove Dependencies
When dependency requirements cannot be satisfied, investigate further:
1. **Version mismatch**: If the dependency is packaged but the version requirement is too strict, add it to `pythonRelaxDeps` to bypass version checking.
2. **Missing dependency**: If the dependency is not packaged, assess whether it's essential for your use case. If not, add it to `pythonRemoveDeps`.
See [darts](./darts/package.nix) for an example.
## Updating an Existing Python Package
Besides the general update steps, also:
1. **Update dependencies**: Check `pyproject.toml` or `setup.py` for changed dependencies and update:
- `dependencies` - Runtime dependencies
- `build-system` - Build-time dependencies (e.g., setuptools, poetry-core)
- `optional-dependencies` - If relevant to your use case
2. **Handle breaking changes**: New versions may:
- Drop Python version support (update `pythonOlder` or `disabled`)
- Change build backends (update `build-system` based on `pyproject.toml`)
- Add new test dependencies (update `nativeCheckInputs` or `checkInputs`)

44
skills/nix-packaging/python/swanboard/package.nix Normal file
View File

@@ -0,0 +1,44 @@
{ lib, buildPythonPackage, pythonOlder, fetchFromGitHub, pytestCheckHook
, hatchling, hatch-fancy-pypi-readme, hatch-requirements-txt, swankit, fastapi
, uvicorn, peewee, ujson, psutil, pyyaml, setuptools, nanoid, numpy }:
# TODO(breakds): Build the UI. It seemed pretty straight forward but
# for some reason I will run into this "dead spiral" of fetchYarnDeps
# always complain about a changed yarn.lock (and hash).
buildPythonPackage rec {
pname = "swanboard";
version = "0.1.7-beta.1";
format = "pyproject";
disabled = pythonOlder "3.8";
src = fetchFromGitHub {
owner = "SwanHubX";
repo = "SwanLab-Dashboard";
rev = "v${version}";
hash = "sha256-jBYlBJaEZPJ2tORfeSUnTpwyAjENh8QYTfVb6o2UNZg=";
};
build-system =
[ hatchling hatch-fancy-pypi-readme hatch-requirements-txt setuptools ];
dependencies = [ swankit fastapi uvicorn peewee ujson psutil pyyaml ];
pythonImportsCheck = [ "swanboard" ];
nativeCheckInputs = [ pytestCheckHook nanoid numpy ];
disabledTests = [
"test_get_package_version_installed"
"test_get_package_version_not_installed"
# Temporarily disable because there is a small bug that needs to be fixed.
"TestExperiment"
];
meta = with lib; {
description = "Swanlab's Dashboard";
homepage = "https://github.com/SwanHubX/SwanLab-Dashboard";
license = licenses.asl20;
maintainers = with maintainers; [ breakds ];
};
}

39
skills/nix-packaging/python/tantivy/package.nix Normal file
View File

@@ -0,0 +1,39 @@
{
lib
, buildPythonPackage
, fetchFromGitHub
, rustPlatform
}:
buildPythonPackage rec {
pname = "tantivy";
version = "0.25.0";
format = "pyproject";
src = fetchFromGitHub {
owner = "quickwit-oss";
repo = "tantivy-py";
tag = version;
hash = "sha256-ZVQOzKojBf7yNkgiOV4huNnuxCmiFwJb610sD4M2/MU=";
};
cargoDeps = rustPlatform.fetchCargoVendor {
inherit pname version src;
hash = "sha256-/OADcVm01PbHp3bcw62Zt6+9ZmT96Bic+EBbPUhdoOI=";
};
build-system = with rustPlatform; [ cargoSetupHook maturinBuildHook ];
pythonImportsCheck = [ "tantivy" ];
meta = {
description = ''
Python bindings for Tantivy; Tantivy is a full-text search engine library
inspired by Apache Lucene and written in Rust
'';
homepage = "https://github.com/quickwit-oss/tantivy-py";
changeLog = "https://github.com/quickwit-oss/tantivy-py/releases/tag/${version}";
license = lib.licenses.mit;
maintainers = with lib.maintainers; [ breakds ];
};
}

27
skills/nix-packaging/python/tyro/package.nix Normal file
View File

@@ -0,0 +1,27 @@
{ lib, buildPythonPackage, fetchFromGitHub, setuptools, docstring-parser
, typing-extensions, rich, shtab, typeguard, hatchling }:
buildPythonPackage rec {
pname = "tyro";
version = "0.9.9";
format = "pyproject";
src = fetchFromGitHub {
owner = "brentyi";
repo = pname;
rev = "v${version}";
hash = "sha256-iFKgnKd4606S/hEMHD7ZaTnGF16gmvbaE62nifw4o7c=";
};
build-system = [ hatchling ];
dependencies = [ docstring-parser typing-extensions rich shtab typeguard ];
pythonImportsCheck = [ "tyro" ];
meta = with lib; {
description = "tool for generating CLI interfaces in Python";
homepage = "https://brentyi.github.io/tyro";
license = licenses.mit;
};
}

74
skills/nix-packaging/rust/codex/package.nix Normal file
View File

@@ -0,0 +1,74 @@
{
lib,
stdenv,
rustPlatform,
fetchFromGitHub,
installShellFiles,
nix-update-script,
pkg-config,
openssl,
versionCheckHook,
installShellCompletions ? stdenv.buildPlatform.canExecute stdenv.hostPlatform,
}:
rustPlatform.buildRustPackage (finalAttrs: {
pname = "codex";
version = "0.46.0";
src = fetchFromGitHub {
owner = "openai";
repo = "codex";
tag = "rust-v${finalAttrs.version}";
hash = "sha256-o898VjjPKevr1VRlRhJUNWsrHEGEn7jkdzWBj+DpbCs=";
};
sourceRoot = "${finalAttrs.src.name}/codex-rs";
cargoHash = "sha256-Qp5zezXjVdOp8OylLgUZRLc0HQlgII6nOZodnOrok6U=";
nativeBuildInputs = [
installShellFiles
pkg-config
];
buildInputs = [ openssl ];
# NOTE: part of the test suite requires access to networking, local shells,
# apple system configuration, etc. since this is a very fast moving target
# (for now), with releases happening every other day, constantly figuring out
# which tests need to be skipped, or finding workarounds, was too burdensome,
# and in practice not adding any real value. this decision may be reversed in
# the future once this software stabilizes.
doCheck = false;
postInstall = lib.optionalString installShellCompletions ''
installShellCompletion --cmd codex \
--bash <($out/bin/codex completion bash) \
--fish <($out/bin/codex completion fish) \
--zsh <($out/bin/codex completion zsh)
'';
doInstallCheck = true;
nativeInstallCheckInputs = [ versionCheckHook ];
passthru = {
updateScript = nix-update-script {
extraArgs = [
"--version-regex"
"^rust-v(\\d+\\.\\d+\\.\\d+)$"
];
};
};
meta = {
description = "Lightweight coding agent that runs in your terminal";
homepage = "https://github.com/openai/codex";
changelog = "https://raw.githubusercontent.com/openai/codex/refs/tags/rust-v${finalAttrs.version}/CHANGELOG.md";
license = lib.licenses.asl20;
mainProgram = "codex";
maintainers = with lib.maintainers; [
malo
delafthi
];
platforms = lib.platforms.unix;
};
})

14
skills/nix-packaging/rust/rust.md Normal file
View File

@@ -0,0 +1,14 @@
# Packaging Rust Applications with Nix
See [codex](./codex/package.nix) for an example.
## Updating an Existing Rust Package
Besides the general update steps, also update the `cargoHash`:
```bash
# Set cargoHash = ""; then run nix build
# Nix will fail and show: "got: sha256-XXXXX"
```
If `Cargo.toml` dependencies changed, the build will automatically fetch new dependencies after you update the `cargoHash`.