No description
  • Rust 89.8%
  • TypeScript 5.3%
  • Shell 1.3%
  • Makefile 0.9%
  • Jinja 0.9%
  • Other 1.6%
Find a file
Hamed Ghasemzadeh aa9a8505f5
Some checks are pending
Build / build (ubuntu-24.04-arm, vm) (push) Waiting to run
Build / build (ubuntu-latest) (push) Waiting to run
Make / ci (push) Waiting to run
base: forgejo-runner in the workspace image
Signed-off-by: Hamed Ghasemzadeh <hg@evgnomon.org>
2026-11-10 11:39:56 +01:00
.agents/skills Workspaces: a shell in your workspace from the browser 2026-11-07 10:46:25 +01:00
.cargo daemon: Fall back to ring on CPUs graviola can't run on 2026-11-05 22:12:34 +01:00
.devcontainer fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
.github remove checkout deps 2026-10-24 20:31:53 +02:00
deploy Retire the Ansible roles, deploy playbooks and one-off tools 2026-10-14 22:08:24 +02:00
docs api: Migrations from the directory, a ledger, and a migrate command 2026-11-05 18:04:39 +01:00
lib base: forgejo-runner in the workspace image 2026-11-10 11:39:56 +01:00
playbooks fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
scripts data: drop the uc-data group, csv2pdf and tidycsv; jsonc into the mkdeb crate 2026-10-22 21:31:47 +02:00
third_party Call Cloudflare's DNS API from Rust and read per-cluster config overrides 2026-10-09 18:31:42 +02:00
.dockerignore Turn the Rust crates under lib/ into one cargo workspace 2026-09-28 20:03:21 +02:00
.gitignore git: ignore settings.json.lock and .test-output 2026-10-23 14:08:02 +02:00
.gitmodules Ignore untracked build files in the cpython submodule 2026-10-13 12:12:38 +02:00
.golangci.yml fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
.ignore fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
AGENTS.md fix working dir 2026-11-06 09:57:51 +01:00
AUTHORS fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
Cargo.lock api: OpenID Connect, so other sites (Forgejo) log in with usecode.dev 2026-11-10 10:13:41 +01:00
Cargo.toml uc: Remove the MongoDB tool (uc db mongo) 2026-11-03 20:28:24 +01:00
CODE_OF_CONDUCT.md fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
CONTRIBUTING.md fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
COPYING fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
DCO Put DCO into the repo 2026-09-25 08:56:17 +02:00
Dockerfile sync: bootstrap with uc sync -t usecode instead of the play.sh scripts; new yubikey, wsl_sudo and vim roles 2026-10-20 08:43:43 +02:00
Makefile Console on the API, at api.usecode.dev, and one make deploy 2026-11-05 18:55:44 +01:00
README.txt usecode: intelligence without overhead 2026-11-07 14:56:00 +01:00
rust-toolchain.toml arm: build uc for aarch64 musl, ci: arm runners for build and dist 2026-10-22 13:11:50 +02:00
SHA512SUMS fix HGL and code of conduct 2026-09-25 09:40:48 +02:00
skills-lock.json uc: Skills, a space to talk to the model, and a snappier hold-to-talk 2026-11-05 05:06:01 +01:00

License-Identifier: HGL
Copyright (C) The Usecode Authors (see AUTHORS)

usecode - Intelligence without overhead
==============================

Use code! When your coding agent can run code, it solves problems better and
burns fewer tokens doing it, so it has more time left for the interesting
stuff.

To run code, an agent needs a place to run it; it can't work in a void.
usecode is that container: machines your agent can spin up, tools it can
run, and an API it can call.

usecode is open source and freely distributed. The code is right here.

The easiest way to use it is usecode.dev. It's already set up and kept
running, so your agents can start working today:

  1. Sign in at https://usecode.dev (free for individuals) and get an API key.
  2. Hand it to your agent. For Claude Code that's one line:

       claude mcp add usecode -e USECODE_MCP_API_KEY=<your key> -- uc-agent-mcp

Cursor, Codex, Gemini CLI, opencode and friends, see:
https://github.com/evgnomon/usecode/blob/master/docs/coding-agents.md

Upgrades, backups and uptime are on us, not your weekend.


Running it yourself
-------------------

The code is here under the HGL General License (COPYING). On a Debian or
Ubuntu box, put the `uc` and `uc-sync` binaries on your PATH, then:

  uc sync -t usecode -d

It clones this repository, installs what the build needs, then builds and
installs the rest of the tools. Then run `uc help`.

Everything usecode.dev hosts, like monitoring, the audit log and backups,
you can run yourself too; it just takes machines and someone watching them.
If you'd rather we make sure it doesn't break, we're happy to talk:
https://usecode.dev


Contributing
------------

Patches are welcome. See CONTRIBUTING.md (commits need a Signed-off-by line)
and CODE_OF_CONDUCT.md.


No Warranty
-----------

The following disclaimers must keep being prominently displayed in the
documentation and any other materials for the Covered Work or a Derivative
Work:

EXCEPT WHEN OTHERWISE STATED IN WRITING, THE COPYRIGHT HOLDERS AND/OR OTHER
PARTIES PROVIDE THE COVERED WORK "AS IS" WITHOUT IMPLIED WARRANTIES OF FITNESS
FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, MERCHANTABILITY AND TITLE, AND ANY
OTHER KIND OF EXPRESSED OR IMPLIED WARRANTIES.

IN NO EVENT SHALL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
LOSS OF GOODWILL, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE
COVERED WORK OR AS A RESULT OF OUR LICENSE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.

Nevertheless, you retain the option to extend offers of support, warranties,
indemnities, or other liability obligations and/or rights in alignment with
this License. Such offers may be provided in exchange for a fee, at your
discretion. This provision allows you to engage in commercial transactions by
offering additional services or assurances while remaining compliant with the
terms of this License.