Skybrush Log Analyzer
Command line application for analyzing ArduPilot logs using Skybrush Log Analyzer.
Agent skill included for AI assistance.
Install
Option A (recommended): install as a tool
uv tool install skybrush-log-analyzer
If uv warns that its tool binary directory (e.g. ~/.local/bin) is not on your PATH, follow its suggestion so skybrush-log-analyzer can be invoked directly.
Option B: run without installing
Skip installation and prefix every CLI command with uvx skybrush-log-analyzer.
How to use
The commands below assume Option A.
- Create a Skybrush API key at https://account.skybrush.io/developer
- Log in with your API key:
skybrush-log-analyzer login - Navigate to the directory containing your log files and analyze a log file:
skybrush-log-analyzer analyze <path-to-log-file>
Run skybrush-log-analyzer --help to see all commands.
Agent skill
The project comes with an agent skill that helps agents use the included CLI to help you with log analysis.
You can install the skill with the following command:
skybrush-log-analyzer add-skill
Or, without installing the CLI:
uvx skybrush-log-analyzer add-skill
Good to know:
- By default, the skill will be installed globally to
.agents/skillsin your home directory. - If you use Claude Code, add the
--claudeoption to the command, which changes the install path to.claude/skills. - To install the skill in the current working directory, use the
--localoption.
Depending on your agent harness, you may need to restart or reload the harness so it recognizes the newly installed skill.
Assuming you logged in and navigated to your log files as described above, all you need to do is start a new agent session, check whether the skybrush-log-analysis skill appears in the list of loaded skills, and prompt the agent to analyze a log file or list available log analysis tests.
Upgrade
When using uv tool, upgrade the CLI and re-install the bundled agent skill so that it matches the new version:
uv tool upgrade skybrush-log-analyzer
skybrush-log-analyzer add-skill --force
When using uvx, the CLI always runs the latest revision, but the installed skill does not follow automatically. Refresh it periodically to avoid inconsistency between the skill and the CLI:
uvx skybrush-log-analyzer add-skill --force
Troubleshooting
[Windows] Character encoding issues
Set PYTHONIOENCODING=utf-8 before commands to avoid Windows codepage errors (e.g. UnicodeEncodeError on µ), or set the PYTHONUTF8=1 environment variable permanently.
1 maintainer
Metadata
1 maintainer
Release files for skybrush-log-analyzer 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| skybrush_log_analyzer-0.3.0.tar.gz | 14.1 kB | With provenance | Details for skybrush_log_analyzer-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| skybrush_log_analyzer-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for skybrush_log_analyzer-0.3.0-py3-none-any.whl |
Total release size: 32.0 kB
Release files / skybrush_log_analyzer-0.3.0.tar.gz
| Download URL | skybrush_log_analyzer-0.3.0.tar.gz |
|---|---|
| Size | 14.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
05231d1ee806904c8990a75f0837b86268962072dabbf3a77e39fca960c3aa65
|
|
BLAKE2b-256 checksum How to use checksums |
6328cf028a517c0662f3ead95ff8317a25b1c910ea9b245886d979eda983966b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logRelease files / skybrush_log_analyzer-0.3.0-py3-none-any.whl
| Download URL | skybrush_log_analyzer-0.3.0-py3-none-any.whl |
|---|---|
| Size | 17.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0ad621f12a570e051e00586e51c27c3ff8b66f0eea35990ad113673ec91e5a49
|
|
BLAKE2b-256 checksum How to use checksums |
f14f7f90025fb6fcac20083423e70e6db2098fd30aab549c3ffcb905490e6155
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logSecurity for skybrush-log-analyzer 0.3.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for skybrush_log_analyzer-0.3.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.
Transparency logA 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.
