Skip to main content

1xops

Command line for 1xops by OceanSoft.io: checks prerequisites, installs the 1xops plugin, and writes settings and read-only cloud connectors for an organisation, a team (or tenant folder), a project, or one person.

uvx 1xops doctor                       # prerequisites and read-only sign-in (account IDs masked)
uvx 1xops install --yes                # add the marketplaces and install the plugin
uvx 1xops setup                        # guided: asks a few questions, writes 1xops.yaml, shows the diff
uvx 1xops profiles                     # built-in connector profiles: aws, azure, itsm
uvx 1xops config --scope team --connectors aws itsm          # shows a diff
uvx 1xops config --scope team --connectors aws itsm --yes    # writes it
Scope Writes Who it is for
org managed-settings.json, managed-mcp.json in --out, for IT to deploy Everyone in the organisation
team .claude/settings.json, .mcp.json in --dir (a project or tenant folder) Everyone on the project, via git
local .claude/settings.local.json in --dir; connectors via the host CLI You, in this project
personal ~/.claude/settings.json; connectors via the host CLI You, in every project

1xops.yaml

One file holds everything a person or team sets. It holds non-secret values only; secrets stay in AWS SSO, az login or the Atlassian sign-in.

scope: team                       # org | team | local | personal
dir: .                            # project or tenant folder (team, local)
connectors:
  aws:
    AWS_BILLING_PROFILE: "billing-readonly"
    AWS_OPERATIONS_PROFILE: "ops-readonly"
    AWS_REGION: "ap-southeast-2"
  itsm: {}
  ./my-profile.json: {}           # your own profile
1xops config --file 1xops.yaml --yes    # apply it
eval "$(1xops env)"                    # team/org: load your values into the shell
  • Keys are the ${VAR} names each profile uses; 1xops profiles lists them.
  • At team and org scope the shared files keep ${VAR}, so profile names and tenant IDs never reach git. The host reads these from your shell environment, so run 1xops env.
  • At local and personal scope the values are written into your private host configuration.
  • Values must be quoted strings, and keys that look like secrets (TOKEN, SECRET, PASSWORD, API_KEY) are refused.
  • Keep a personal 1xops.yaml out of git.

Rules

  • Nothing changes without --yes.
  • Existing values are never overwritten; only missing entries are added.
  • Built-in profiles pin every server version and use ${VAR} references for profiles, tokens and URLs, so no secret is written to a file.
  • Your own profile is a JSON file with an mcpServers object: --connectors ./my-profile.json.

Licence: Apache-2.0. © 2026 Nhat-Thanh Nguyen (nnthanh101@gmail.com), OceanSoft.io. Licence, trademarks and third-party components: NOTICE.

Metadata

Release files for 1xops 0.2.1

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

Source distribution (sdist)

Source distribution for 1xops 0.2.1
File Size Uploaded Provenance Actions
1xops-0.2.1.tar.gz 11.5 kB With provenance Details for 1xops-0.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for 1xops 0.2.1
File Interpreter ABI Platform Actions
1xops-0.2.1-py3-none-any.whl Python 3 none any Details for 1xops-0.2.1-py3-none-any.whl

Total release size: 25.0 kB

Release files / 1xops-0.2.1.tar.gz

Download URL 1xops-0.2.1.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b35846ec162e15d8b3659c47e1d71d0587c9c38fca36a957dcededa64b99db40
BLAKE2b-256 checksum
How to use checksums
49d8a09a1b918bf552ceb6db33a1f9532c434d69aa4e0eb703d3a85efef7ea25
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 Nov 17, 2026.

Transparency log

Release files / 1xops-0.2.1-py3-none-any.whl

Download URL 1xops-0.2.1-py3-none-any.whl
Size 13.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
94c6b6e686e91e2ea782cd80ba637f2ff343e41e9aaa45ad1c28bfc7db1e053a
BLAKE2b-256 checksum
How to use checksums
7a477a83df09faf7ad6f8b6a14e80bcb5b093fb6caf94515b58468c3fe3a2859
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 Nov 17, 2026.

Transparency log

Security for 1xops 0.2.1

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.

Select from 2 files

Attestation for 1xops-0.2.1.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 Nov 17, 2026.

Transparency log

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