Skip to main content

ByteAsk

An AI coding agent for your terminal. byteask drops a capable agent into your shell — an interactive TUI, real tool use, and first-class C/C++ tooling — talking to the self-hosted ByteAsk gateway.

PyPI npm Python

$ byteask

That's it — one command drops you into an interactive session. First run signs you in; after that, just type.


Install

Pick whichever fits your setup — they all install the same native engine and share one runtime, so switching between them is free.

pip

pip install byteask

uv

uv tool install byteask     # or:  uv pip install byteask   /   uvx byteask

npm

npm install -g @byteask/cli
# or, no install:
npx @byteask/cli

Shell (Linux / macOS)

curl -fsSL https://code.byteask.ai/install.sh | sh

PowerShell (Windows)

irm https://code.byteask.ai/install.ps1 | iex

The pip, uv, and npm packages bundle the native engine for your platform — pip install / npm i gets you a working tool with no extra download. (On a platform without a prebuilt binary they fall back to fetching it once.) The installed command is byteask on every path.


Quickstart

# 1. Sign in (magic link to your email) — or just run `byteask`, it onboards you.
byteask login --email you@company.com

# 2. Start coding, interactively:
byteask

# 3. Or one-shot a question against the current repo:
byteask "explain what this service does and where the entrypoint is"

Inside the session, type your task in plain English. The agent reads files, runs tools, and proposes edits — you stay in control of what it applies.


Commands

Command What it does
byteask Open the interactive agent (the default)
byteask "…" Run a one-shot prompt against the current directory
byteask login Sign in (magic link → token)
byteask logout Sign out on this machine
byteask --update Update to the latest engine
byteask --version Print the version

Inside the TUI, slash commands include /login, /logout, /usage (your quota), /upgrade (Pro / Max), /referral-code, and /status.


What you get

  • Interactive TUI — a real terminal agent, not a chat box: it navigates the repo, runs commands, and shows diffs before applying.
  • First-class C/C++ tooling — 16 native tools wired in: Compiler Explorer (godbolt), gdb/lldb, ASan/UBSan/valgrind, clang-tidy, clang-format, clangd navigation, perf/callgrind, quick-bench, cppinsights, objdump/nm/readelf, Intel intrinsics lookup, and more. The agent reaches for them on the tasks that need them.
  • Web search built in.
  • Zero data retention — your prompts and code are not used to train models.
  • Usage that's visible — /usage shows exactly where you stand; upgrade in-app with /upgrade.

Platforms

OS Architecture libc
Linux x86_64, arm64 glibc
macOS Apple Silicon (arm64) —
Windows x86_64 —

Alpine / musl isn't supported (a core dependency ships no musl build). On Alpine, use WSL or a glibc base image.


How it works

byteask is a thin client. The intelligence and your account live behind the ByteAsk gateway; the local binary is the agent runtime plus a small launcher that handles sign-in, updates, and your config in ~/.byteask. Your model key never touches your machine.


© ByteAsk. All rights reserved.

Metadata

Release files for byteask 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for byteask 0.2.3
File Size Uploaded Provenance Actions
byteask-0.2.3.tar.gz 5.6 kB Without provenance Details for byteask-0.2.3.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for byteask 0.2.3
File Actions
byteask-0.2.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for byteask-0.2.3-py3-none-win_amd64.whl
byteask-0.2.3-py3-none-manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for byteask-0.2.3-py3-none-manylinux2014_x86_64.whl
byteask-0.2.3-py3-none-manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for byteask-0.2.3-py3-none-manylinux2014_aarch64.whl
byteask-0.2.3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for byteask-0.2.3-py3-none-macosx_11_0_arm64.whl
byteask-0.2.3-py3-none-any.whl Python 3 none any Details for byteask-0.2.3-py3-none-any.whl

Total release size: 289.8 MB

Release files / byteask-0.2.3.tar.gz

Download URL byteask-0.2.3.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
cf9d45f4a5e8169ed126d567ef3b6fa364b9a10c0b40b6bf2e881427ba18747c
BLAKE2b-256 checksum
How to use checksums
9be4669c9c65aa236926bde31ddbf6a860f97bb408e86f6910279382a40b9ebc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Release files / byteask-0.2.3-py3-none-win_amd64.whl

Download URL byteask-0.2.3-py3-none-win_amd64.whl
Size 73.5 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
a6a6533dacc63528e3089c60e6a6d3c4d04c172d0a20d54d4d8e9148f571e951
BLAKE2b-256 checksum
How to use checksums
240da7802f4e7709493e662c195d1d7dd95b8cba20f172bcde3cf1d535e49e15
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Release files / byteask-0.2.3-py3-none-manylinux2014_x86_64.whl

Download URL byteask-0.2.3-py3-none-manylinux2014_x86_64.whl
Size 80.9 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
73ab4b89f6075db15a0cc0d9a8c54ad7651031b312ecb107a17db399ac36a7bb
BLAKE2b-256 checksum
How to use checksums
e7ca2a0528fa722d4cbdb20f1ff79345ca8d63442cfac92223a8c282d0475ca3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Release files / byteask-0.2.3-py3-none-manylinux2014_aarch64.whl

Download URL byteask-0.2.3-py3-none-manylinux2014_aarch64.whl
Size 75.3 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
35dbfda114d1e9aa732dfc7d6c24b94e925292b8807a840dc9cb9a6b9076a454
BLAKE2b-256 checksum
How to use checksums
89b2da8e88c3ef8d76ef9214d4e51bc1bf55ca078ed20dabe534000df4c842bd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Release files / byteask-0.2.3-py3-none-macosx_11_0_arm64.whl

Download URL byteask-0.2.3-py3-none-macosx_11_0_arm64.whl
Size 60.0 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
9102752c01a6413389780f515b115f8efc02b79fb218287bebbe2b84d9602ebc
BLAKE2b-256 checksum
How to use checksums
d1524e22f0708bd37da0150f4e8a775a2e5bafaabb6eeae733e526afd535fbdd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Release files / byteask-0.2.3-py3-none-any.whl

Download URL byteask-0.2.3-py3-none-any.whl
Size 5.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
43768e35eac69bd209ffbac805952beeb02341ee9b98b4827fdfeb0b6764500c
BLAKE2b-256 checksum
How to use checksums
9f906248c021a6fff86f0fd42e5500d3796af823001661d75a64900f68e3818a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Security for byteask 0.2.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page