praetorian-cli 2.2.17__tar.gz → 2.3.0__tar.gz

{praetorian_cli-2.2.17/praetorian_cli.egg-info → praetorian_cli-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: praetorian-cli
-Version: 2.2.17
+Version: 2.3.0
 Summary: For interacting with the Chariot API
 Home-page: https://github.com/praetorian-inc/praetorian-cli
 Author: Praetorian
@@ -31,7 +31,7 @@ Dynamic: license-file
 [![Open Source Libraries](https://img.shields.io/badge/Open--source-%F0%9F%92%9A-28a745)](https://opensource.org/)
 [![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg?style=flat)](https://github.com/praetorian-inc/chariot-ui/issues)
 
-:link: [Chariot Platform](https://chariot.praetorian.com)
+:link: [Guard Platform](https://guard.praetorian.com)
 :book: [Documentation](https://docs.praetorian.com)
 :bookmark: [PyPI](https://pypi.org/project/praetorian-cli/)
 
@@ -48,14 +48,15 @@ Dynamic: license-file
 - [Contributing](#contributing)
 - [Support](#support)
 - [License](#license)
+- [Backwards Compatibility](#backwards-compatibility)
 
 # Description
 
 Praetorian CLI and SDK are open-source tools for interacting with our products and services. Currently, they support
-access to [Chariot](https://www.praetorian.com/proactive-cybersecurity-technology/), our
+access to [Guard](https://www.praetorian.com/proactive-cybersecurity-technology/), our
 offensive security platform.
-<br> The SDK exposes the full set of APIs that the Chariot UI uses.
-<br> The CLI is a fully-featured companion to the Chariot UI.
+<br> The SDK exposes the full set of APIs that the Guard UI uses.
+<br> The CLI is a fully-featured companion to the Guard UI.
 
 # Getting Started
 
@@ -74,14 +75,14 @@ pip install praetorian-cli
 
 ## Signing up
 
-Register for an account for [Chariot](http://chariot.praetorian.com) using the instructions
+Register for an account for [Guard](http://guard.praetorian.com) using the instructions
 in [our documentation](https://docs.praetorian.com/hc/en-us/articles/38048335323547-Account-Creation-and-Attack-Surface-Setup).
 
 ## Authentication
 
-Once you can properly access Chariot through the UI. You can obtain API credentials through the UI under
+Once you can properly access Guard through the UI. You can obtain API credentials through the UI under
 Settings -> User Settings -> API Keys. Be sure to careful copy the API credentials you created as
-you will need to provide them to the CLI for interacting with Chariot. 
+you will need to provide them to the CLI for interacting with Guard. 
 
 **Note**: SSO Organizations should provision access through API Keys as well.
 
@@ -123,49 +124,49 @@ For more advanced configuration options or managing access in SSO organizations
 
 # Using the CLI
 
-The CLI is a command and option utility for accessing the full suite of Chariot's API. You can see the documentation for commands
+The CLI is a command and option utility for accessing the full suite of Guard's API. You can see the documentation for commands
 using the `help` option:
 
 ```zsh
-praetorian chariot --help
+guard --help
 ```
 
 As an example, run the following command to retrieve the list of all assets in your account:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot list assets
+guard --account guard+example@praetorian.com list assets
 ```
 
-You can obtain the `account` argument by viewing the email of the first user on the Users page in your Chariot account, as shown below:
+You can obtain the `account` argument by viewing the email of the first user on the Users page in your Guard account, as shown below:
 
 <img width="482" alt="image" src="https://github.com/user-attachments/assets/7c1024c9-7b74-46b1-87c5-af44671b1ec8" />
 
 To get detailed information about a specific asset, run:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot get asset <ASSET_KEY>
+guard --account guard+example@praetorian.com get asset <ASSET_KEY>
 ```
 
 # Developers
 
 Both CLI and SDK is open-source in this repository. The SDK is installed along with the `praetorian-cli`
-package. You can extend Chariot by creating scripts using the SDK.
+package. You can extend Guard by creating scripts using the SDK.
 
 ## SDK
 
 Integrate the SDK into your own Python application with the following steps:
 
 1. Include the dependency ``praetorian-cli`` in your project.
-2. Import the Chariot class ``from praetorian_cli.sdk.chariot import Chariot``.
+2. Import the Guard class ``from praetorian_cli.sdk.guard import Guard``.
 3. Import the Keychain class ``from praetorian_cli.sdk.keychain import Keychain``.
-4. Call any function of the Chariot class, which expose the full backend API. See example below:
+4. Call any function of the Guard class, which expose the full backend API. See example below:
 
 ```python
-from praetorian_cli.sdk.chariot import Chariot
+from praetorian_cli.sdk.guard import Guard
 from praetorian_cli.sdk.keychain import Keychain
 
-chariot = Chariot(Keychain(account='chariot+example@praetorian.com'))
-chariot.add('asset', dict(name='example.com', dns='example.com'))
+guard = Guard(Keychain(account='guard+example@praetorian.com'))
+guard.add('asset', dict(name='example.com', dns='example.com'))
 ```
 
 The best place to explore the SDK is the code of the CLI, especially
@@ -184,7 +185,7 @@ environment to point to directories where you store additional extension scripts
 Those external scripts are available under the `script` commands. To see a list of them:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot script --help
+guard --account guard+example@praetorian.com script --help
 ```
 
 For developing scripts, you can refer to
@@ -209,3 +210,39 @@ If you have any questions or need support, please open an issue
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+# Backwards Compatibility
+
+**Guard** is a rebrand of **Chariot**.
+
+### CLI
+The `guard` command is the new primary CLI entry point. The legacy `praetorian chariot` command continues to work:
+
+```zsh
+# New (preferred):
+guard list assets
+guard --account example@praetorian.com list assets
+guard configure
+
+# Legacy (still supported):
+praetorian chariot list assets
+praetorian configure
+```
+
+### SDK
+Both `Guard` and `Chariot` classes are available and interchangeable:
+
+```python
+# New (preferred):
+from praetorian_cli.sdk.guard import Guard
+guard = Guard(Keychain())
+
+# Legacy (still supported):
+from praetorian_cli.sdk.chariot import Chariot
+chariot = Chariot(Keychain())
+```
+
+### Configuration
+The keychain file and environment variables remain unchanged. Existing configurations will continue to work without modification.

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/README.md

@@ -7,7 +7,7 @@
 [![Open Source Libraries](https://img.shields.io/badge/Open--source-%F0%9F%92%9A-28a745)](https://opensource.org/)
 [![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg?style=flat)](https://github.com/praetorian-inc/chariot-ui/issues)
 
-:link: [Chariot Platform](https://chariot.praetorian.com)
+:link: [Guard Platform](https://guard.praetorian.com)
 :book: [Documentation](https://docs.praetorian.com)
 :bookmark: [PyPI](https://pypi.org/project/praetorian-cli/)
 
@@ -24,14 +24,15 @@
 - [Contributing](#contributing)
 - [Support](#support)
 - [License](#license)
+- [Backwards Compatibility](#backwards-compatibility)
 
 # Description
 
 Praetorian CLI and SDK are open-source tools for interacting with our products and services. Currently, they support
-access to [Chariot](https://www.praetorian.com/proactive-cybersecurity-technology/), our
+access to [Guard](https://www.praetorian.com/proactive-cybersecurity-technology/), our
 offensive security platform.
-<br> The SDK exposes the full set of APIs that the Chariot UI uses.
-<br> The CLI is a fully-featured companion to the Chariot UI.
+<br> The SDK exposes the full set of APIs that the Guard UI uses.
+<br> The CLI is a fully-featured companion to the Guard UI.
 
 # Getting Started
 
@@ -50,14 +51,14 @@ pip install praetorian-cli
 
 ## Signing up
 
-Register for an account for [Chariot](http://chariot.praetorian.com) using the instructions
+Register for an account for [Guard](http://guard.praetorian.com) using the instructions
 in [our documentation](https://docs.praetorian.com/hc/en-us/articles/38048335323547-Account-Creation-and-Attack-Surface-Setup).
 
 ## Authentication
 
-Once you can properly access Chariot through the UI. You can obtain API credentials through the UI under
+Once you can properly access Guard through the UI. You can obtain API credentials through the UI under
 Settings -> User Settings -> API Keys. Be sure to careful copy the API credentials you created as
-you will need to provide them to the CLI for interacting with Chariot. 
+you will need to provide them to the CLI for interacting with Guard. 
 
 **Note**: SSO Organizations should provision access through API Keys as well.
 
@@ -99,49 +100,49 @@ For more advanced configuration options or managing access in SSO organizations
 
 # Using the CLI
 
-The CLI is a command and option utility for accessing the full suite of Chariot's API. You can see the documentation for commands
+The CLI is a command and option utility for accessing the full suite of Guard's API. You can see the documentation for commands
 using the `help` option:
 
 ```zsh
-praetorian chariot --help
+guard --help
 ```
 
 As an example, run the following command to retrieve the list of all assets in your account:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot list assets
+guard --account guard+example@praetorian.com list assets
 ```
 
-You can obtain the `account` argument by viewing the email of the first user on the Users page in your Chariot account, as shown below:
+You can obtain the `account` argument by viewing the email of the first user on the Users page in your Guard account, as shown below:
 
 <img width="482" alt="image" src="https://github.com/user-attachments/assets/7c1024c9-7b74-46b1-87c5-af44671b1ec8" />
 
 To get detailed information about a specific asset, run:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot get asset <ASSET_KEY>
+guard --account guard+example@praetorian.com get asset <ASSET_KEY>
 ```
 
 # Developers
 
 Both CLI and SDK is open-source in this repository. The SDK is installed along with the `praetorian-cli`
-package. You can extend Chariot by creating scripts using the SDK.
+package. You can extend Guard by creating scripts using the SDK.
 
 ## SDK
 
 Integrate the SDK into your own Python application with the following steps:
 
 1. Include the dependency ``praetorian-cli`` in your project.
-2. Import the Chariot class ``from praetorian_cli.sdk.chariot import Chariot``.
+2. Import the Guard class ``from praetorian_cli.sdk.guard import Guard``.
 3. Import the Keychain class ``from praetorian_cli.sdk.keychain import Keychain``.
-4. Call any function of the Chariot class, which expose the full backend API. See example below:
+4. Call any function of the Guard class, which expose the full backend API. See example below:
 
 ```python
-from praetorian_cli.sdk.chariot import Chariot
+from praetorian_cli.sdk.guard import Guard
 from praetorian_cli.sdk.keychain import Keychain
 
-chariot = Chariot(Keychain(account='chariot+example@praetorian.com'))
-chariot.add('asset', dict(name='example.com', dns='example.com'))
+guard = Guard(Keychain(account='guard+example@praetorian.com'))
+guard.add('asset', dict(name='example.com', dns='example.com'))
 ```
 
 The best place to explore the SDK is the code of the CLI, especially
@@ -160,7 +161,7 @@ environment to point to directories where you store additional extension scripts
 Those external scripts are available under the `script` commands. To see a list of them:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot script --help
+guard --account guard+example@praetorian.com script --help
 ```
 
 For developing scripts, you can refer to
@@ -185,3 +186,39 @@ If you have any questions or need support, please open an issue
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+# Backwards Compatibility
+
+**Guard** is a rebrand of **Chariot**.
+
+### CLI
+The `guard` command is the new primary CLI entry point. The legacy `praetorian chariot` command continues to work:
+
+```zsh
+# New (preferred):
+guard list assets
+guard --account example@praetorian.com list assets
+guard configure
+
+# Legacy (still supported):
+praetorian chariot list assets
+praetorian configure
+```
+
+### SDK
+Both `Guard` and `Chariot` classes are available and interchangeable:
+
+```python
+# New (preferred):
+from praetorian_cli.sdk.guard import Guard
+guard = Guard(Keychain())
+
+# Legacy (still supported):
+from praetorian_cli.sdk.chariot import Chariot
+chariot = Chariot(Keychain())
+```
+
+### Configuration
+The keychain file and environment variables remain unchanged. Existing configurations will continue to work without modification.

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/add.py

@@ -12,7 +12,7 @@ from praetorian_cli.sdk.model.globals import AddRisk, Asset, Seed, Kind
 
 @chariot.group()
 def add():
-    """ Add an entity to Chariot """
+    """ Add an entity to Guard """
     pass
 
 
@@ -27,7 +27,7 @@ def add():
 def asset(sdk, name, dns, asset_type, status, surface):
     """ Add an asset
 
-    Add an asset to the Chariot database. This command requires a DNS name for the asset.
+    Add an asset to the Guard database. This command requires a DNS name for the asset.
     Optionally, a name can be provided to give the asset more specific information,
     such as IP address. If no name is provided, the DNS name will be used as the name.
     The DNS is the group and the name is the specific identifier. This is for legacy reasons.
@@ -55,12 +55,12 @@ def asset(sdk, name, dns, asset_type, status, surface):
 @add.command()
 @cli_handler
 @click.argument('path')
-@click.option('-n', '--name', help='The file name in Chariot. Default: the full path of the uploaded file')
+@click.option('-n', '--name', help='The file name in Guard. Default: the full path of the uploaded file')
 def file(sdk, path, name):
     """ Upload a file
 
     This commands takes the path to a local file and uploads it to the
-    Chariot file system. The Chariot file system is where the platform
+    Guard file system. The Guard file system is where the platform
     stores proofs of exploit, risk definitions, and other supporting data.
 
     User files reside in the "home/" folder. Those files appear in the app
@@ -89,7 +89,7 @@ def definition(sdk, path, name):
     """ Upload a risk definition
 
     This commands takes the path to the local file and uploads it to the
-    Chariot file system as risk definitions. Risk definitions reside
+    Guard file system as risk definitions. Risk definitions reside
     in the "definitions/" folder in the file system.
 
     Risk definitions need to be in the Markdown format.
@@ -141,7 +141,7 @@ def webhook(sdk):
 def risk(sdk, name, asset, status, comment, capability):
     """ Add a risk
 
-    This command adds a risk to Chariot. A risk must have an associated asset.
+    This command adds a risk to Guard. A risk must have an associated asset.
     The asset is specified by its key, which can be retrieved by listing and
     searching the assets.
 
@@ -211,7 +211,7 @@ def attribute(sdk, key, name, value):
 def seed(sdk, seed_type, status, field_list):
     """ Add a seed
 
-    Add a seed to the Chariot database. Seeds are now assets with special labeling.
+    Add a seed to the Guard database. Seeds are now assets with special labeling.
     You can specify the asset type and provide dynamic fields using --fields.
 
     \b
@@ -247,7 +247,7 @@ def seed(sdk, seed_type, status, field_list):
 def preseed(sdk, type, title, value, status):
     """ Add a preseed
 
-    This command adds a preseed to the Chariot database.
+    This command adds a preseed to the Guard database.
     Preseeds default to ACTIVE and cannot be added as PENDING.
 
     \b
@@ -337,7 +337,7 @@ def key(sdk, name, expires):
 def webpage(sdk, url, parent):
     """ Add a Webpage
 
-    Add a web page to the Chariot database. Webpages can optionally be associated
+    Add a web page to the Guard database. Webpages can optionally be associated
     with a parent WebApplication or exist independently.
 
     \b

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/agent.py

@@ -29,14 +29,14 @@ def affiliation(sdk, key):
 
 @agent.group()
 def mcp():
-    """ Chariot's MCP server """
+    """ Guard's MCP server """
     pass
 
 @mcp.command()
 @cli_handler
 @click.option('--allowed', '-a', type=str, multiple=True, default=['search_by_query', '*_list', '*_get'])
 def start(sdk, allowed):
-    """ Starts the Chariot MCP server
+    """ Starts the Guard MCP server
 
     \b
     Example usages:
@@ -73,9 +73,9 @@ def tools(sdk, allowed):
 @agent.command()
 @cli_handler
 def conversation(sdk):
-    """ Interactive conversation with Chariot AI assistant
+    """ Interactive conversation with Guard AI assistant
     
-    Start an interactive chat session with the Chariot AI assistant.
+    Start an interactive chat session with the Guard AI assistant.
     The AI can help you query security data, understand findings,
     and provide insights about your attack surface.
     

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/chariot.py

@@ -7,7 +7,7 @@ def chariot(click_context):
     # import done here to avoid circular import errors in praetorian_cli/handlers/cli_decorators.py
     from praetorian_cli.sdk.chariot import Chariot
 
-    """ Command group for interacting with the Chariot product """
+    """ Command group for interacting with the Guard product """
     # Replace the click context (previously a Keychain instance) with a Chariot
     # instance, after creating it using the Keychain instance.
     keychain = click_context.obj['keychain']

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/delete.py

@@ -7,7 +7,7 @@ from praetorian_cli.sdk.model.globals import Risk
 
 @chariot.group()
 def delete():
-    """ Delete an entity from Chariot """
+    """ Delete an entity from Guard """
     pass
 
 
@@ -106,7 +106,7 @@ def file(chariot, filepath):
 
     \b
     Arguments:
-        - FILEPATH: The Chariot file path
+        - FILEPATH: The Guard file path
 
     \b
     Example usage:

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/get.py

@@ -9,7 +9,7 @@ from praetorian_cli.handlers.utils import print_json
 
 @chariot.group()
 def get():
-    """ Get entity details from Chariot """
+    """ Get entity details from Guard """
     pass
 
 
@@ -319,13 +319,15 @@ def webpage(chariot, key):
     """
     print_json(chariot.webpage.get(key))
         
+@get.command()
+@cli_handler
 @click.option('-t', '--type', help='Optional specific entity type (e.g., asset, risk, attribute)')
 @click.option('-d', '--details', is_flag=True, help='Further retrieve the details of the schema')
 def schema(chariot, type, details):
-    """ Get Chariot entity schema
+    """ Get Guard entity schema
 
     \b
-    Returns the JSON schema for Chariot entities. Optionally filter for a
+    Returns the JSON schema for Guard entities. Optionally filter for a
     specific entity type.
 
     \b

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/imports.py

@@ -6,7 +6,7 @@ from praetorian_cli.handlers.cli_decorators import cli_handler
 
 @chariot.group()
 def imports():
-    """ Import data to Chariot """
+    """ Import data to Guard """
     pass
 
 

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/list.py

@@ -7,7 +7,7 @@ from praetorian_cli.handlers.utils import render_offset, render_list_results, pa
 
 @chariot.group()
 def list():
-    """ Get a list of entities from Chariot """
+    """ Get a list of entities from Guard """
     pass
 
 
@@ -121,7 +121,7 @@ def jobs(chariot, filter, details, offset, page):
 def files(chariot, filter, details, offset, page):
     """ List files
 
-    Retrieve and display a list of files in the Chariot file system.
+    Retrieve and display a list of files in the Guard file system.
 
     \b
     Example usages:

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/search.py

@@ -16,7 +16,7 @@ from praetorian_cli.sdk.model.globals import Kind
 @click.option('-desc', '--desc', is_flag=True, default=False, help='Return data in descending order')
 @click.option('-g', '--global', 'global_', is_flag=True, default=False, help='Use the global data set')
 def search(chariot, term, count, kind, details, offset, page, desc, global_):
-    """ Query Chariot for matches or counts using the search syntax
+    """ Query Guard for matches or counts using the search syntax
 
     \b
     Search syntax:

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/handlers/update.py

@@ -7,7 +7,7 @@ from praetorian_cli.sdk.model.globals import Risk, Seed, Asset
 
 @chariot.group()
 def update():
-    """ Update an entity in Chariot """
+    """ Update an entity in Guard """
     pass
 
 

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/main.py

@@ -36,3 +36,26 @@ def main(click_context, profile, account, debug, proxy):
 
 main.add_command(chariot)
 main.add_command(configure)
+
+
+@click.group()
+@click.option('--profile', default='United States', help='The profile to use in the keychain file', show_default=True)
+@click.option('--account', default=None, help='Assume role into this account')
+@click.option('--debug', is_flag=True, default=False, help='Run the CLI in debug mode')
+@click.option('--proxy', default='', help='The proxy to use in the CLI')
+@click.pass_context
+@click.version_option()
+def guard_main(click_context, profile, account, debug, proxy):
+    """Guard CLI - Praetorian's offensive security platform."""
+    from praetorian_cli.sdk.chariot import Chariot
+    if debug:
+        click.echo('Running in debug mode.')
+    chariot.is_debug = debug
+    click_context.obj = Chariot(Keychain(profile, account), proxy=proxy)
+    praetorian_cli.handlers.script.load_dynamic_commands()
+
+
+# Add all chariot commands to guard_main
+for cmd_name, cmd in chariot.commands.items():
+    guard_main.add_command(cmd, cmd_name)
+guard_main.add_command(configure)

praetorian_cli-2.3.0/praetorian_cli/sdk/guard.py

@@ -0,0 +1,7 @@
+"""Guard SDK alias for Chariot."""
+
+from praetorian_cli.sdk.chariot import Chariot
+
+Guard = Chariot
+
+__all__ = ["Guard"]

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli/sdk/test/test_z_cli.py

@@ -390,8 +390,14 @@ class TestZCli:
         self.verify('agent --help', ignore_stdout=True)
         self.verify('agent affiliation --help', ignore_stdout=True)
         
+    def test_guard_cli(self):
+        """Test the 'guard' entry point works correctly."""
+        self.verify('configure --help', expected_stdout=['Configure the CLI'])
+        self.verify('--help', expected_stdout=['configure', 'list', 'add', 'delete', 'update'])
+        self.verify('list --help', expected_stdout=['assets', 'risks', 'accounts'])
+
     def verify(self, command, expected_stdout=[], expected_stderr=[], ignore_stdout=False):
-        result = run(f'praetorian --profile "{self.sdk.keychain.profile}" chariot {command}', capture_output=True,
+        result = run(f'guard --profile "{self.sdk.keychain.profile}" {command}', capture_output=True,
                      text=True, shell=True)
         if expected_stdout:
             for out in expected_stdout:

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0/praetorian_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: praetorian-cli
-Version: 2.2.17
+Version: 2.3.0
 Summary: For interacting with the Chariot API
 Home-page: https://github.com/praetorian-inc/praetorian-cli
 Author: Praetorian
@@ -31,7 +31,7 @@ Dynamic: license-file
 [![Open Source Libraries](https://img.shields.io/badge/Open--source-%F0%9F%92%9A-28a745)](https://opensource.org/)
 [![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg?style=flat)](https://github.com/praetorian-inc/chariot-ui/issues)
 
-:link: [Chariot Platform](https://chariot.praetorian.com)
+:link: [Guard Platform](https://guard.praetorian.com)
 :book: [Documentation](https://docs.praetorian.com)
 :bookmark: [PyPI](https://pypi.org/project/praetorian-cli/)
 
@@ -48,14 +48,15 @@ Dynamic: license-file
 - [Contributing](#contributing)
 - [Support](#support)
 - [License](#license)
+- [Backwards Compatibility](#backwards-compatibility)
 
 # Description
 
 Praetorian CLI and SDK are open-source tools for interacting with our products and services. Currently, they support
-access to [Chariot](https://www.praetorian.com/proactive-cybersecurity-technology/), our
+access to [Guard](https://www.praetorian.com/proactive-cybersecurity-technology/), our
 offensive security platform.
-<br> The SDK exposes the full set of APIs that the Chariot UI uses.
-<br> The CLI is a fully-featured companion to the Chariot UI.
+<br> The SDK exposes the full set of APIs that the Guard UI uses.
+<br> The CLI is a fully-featured companion to the Guard UI.
 
 # Getting Started
 
@@ -74,14 +75,14 @@ pip install praetorian-cli
 
 ## Signing up
 
-Register for an account for [Chariot](http://chariot.praetorian.com) using the instructions
+Register for an account for [Guard](http://guard.praetorian.com) using the instructions
 in [our documentation](https://docs.praetorian.com/hc/en-us/articles/38048335323547-Account-Creation-and-Attack-Surface-Setup).
 
 ## Authentication
 
-Once you can properly access Chariot through the UI. You can obtain API credentials through the UI under
+Once you can properly access Guard through the UI. You can obtain API credentials through the UI under
 Settings -> User Settings -> API Keys. Be sure to careful copy the API credentials you created as
-you will need to provide them to the CLI for interacting with Chariot. 
+you will need to provide them to the CLI for interacting with Guard. 
 
 **Note**: SSO Organizations should provision access through API Keys as well.
 
@@ -123,49 +124,49 @@ For more advanced configuration options or managing access in SSO organizations
 
 # Using the CLI
 
-The CLI is a command and option utility for accessing the full suite of Chariot's API. You can see the documentation for commands
+The CLI is a command and option utility for accessing the full suite of Guard's API. You can see the documentation for commands
 using the `help` option:
 
 ```zsh
-praetorian chariot --help
+guard --help
 ```
 
 As an example, run the following command to retrieve the list of all assets in your account:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot list assets
+guard --account guard+example@praetorian.com list assets
 ```
 
-You can obtain the `account` argument by viewing the email of the first user on the Users page in your Chariot account, as shown below:
+You can obtain the `account` argument by viewing the email of the first user on the Users page in your Guard account, as shown below:
 
 <img width="482" alt="image" src="https://github.com/user-attachments/assets/7c1024c9-7b74-46b1-87c5-af44671b1ec8" />
 
 To get detailed information about a specific asset, run:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot get asset <ASSET_KEY>
+guard --account guard+example@praetorian.com get asset <ASSET_KEY>
 ```
 
 # Developers
 
 Both CLI and SDK is open-source in this repository. The SDK is installed along with the `praetorian-cli`
-package. You can extend Chariot by creating scripts using the SDK.
+package. You can extend Guard by creating scripts using the SDK.
 
 ## SDK
 
 Integrate the SDK into your own Python application with the following steps:
 
 1. Include the dependency ``praetorian-cli`` in your project.
-2. Import the Chariot class ``from praetorian_cli.sdk.chariot import Chariot``.
+2. Import the Guard class ``from praetorian_cli.sdk.guard import Guard``.
 3. Import the Keychain class ``from praetorian_cli.sdk.keychain import Keychain``.
-4. Call any function of the Chariot class, which expose the full backend API. See example below:
+4. Call any function of the Guard class, which expose the full backend API. See example below:
 
 ```python
-from praetorian_cli.sdk.chariot import Chariot
+from praetorian_cli.sdk.guard import Guard
 from praetorian_cli.sdk.keychain import Keychain
 
-chariot = Chariot(Keychain(account='chariot+example@praetorian.com'))
-chariot.add('asset', dict(name='example.com', dns='example.com'))
+guard = Guard(Keychain(account='guard+example@praetorian.com'))
+guard.add('asset', dict(name='example.com', dns='example.com'))
 ```
 
 The best place to explore the SDK is the code of the CLI, especially
@@ -184,7 +185,7 @@ environment to point to directories where you store additional extension scripts
 Those external scripts are available under the `script` commands. To see a list of them:
 
 ```zsh
-praetorian --account chariot+example@praetorian.com chariot script --help
+guard --account guard+example@praetorian.com script --help
 ```
 
 For developing scripts, you can refer to
@@ -209,3 +210,39 @@ If you have any questions or need support, please open an issue
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+# Backwards Compatibility
+
+**Guard** is a rebrand of **Chariot**.
+
+### CLI
+The `guard` command is the new primary CLI entry point. The legacy `praetorian chariot` command continues to work:
+
+```zsh
+# New (preferred):
+guard list assets
+guard --account example@praetorian.com list assets
+guard configure
+
+# Legacy (still supported):
+praetorian chariot list assets
+praetorian configure
+```
+
+### SDK
+Both `Guard` and `Chariot` classes are available and interchangeable:
+
+```python
+# New (preferred):
+from praetorian_cli.sdk.guard import Guard
+guard = Guard(Keychain())
+
+# Legacy (still supported):
+from praetorian_cli.sdk.chariot import Chariot
+chariot = Chariot(Keychain())
+```
+
+### Configuration
+The keychain file and environment variables remain unchanged. Existing configurations will continue to work without modification.

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli.egg-info/SOURCES.txt

@@ -37,6 +37,7 @@ praetorian_cli/scripts/commands/__init__.py
 praetorian_cli/scripts/commands/nmap-example.py
 praetorian_cli/sdk/__init__.py
 praetorian_cli/sdk/chariot.py
+praetorian_cli/sdk/guard.py
 praetorian_cli/sdk/keychain.py
 praetorian_cli/sdk/mcp_server.py
 praetorian_cli/sdk/entities/__init__.py

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/praetorian_cli.egg-info/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+guard = praetorian_cli.main:guard_main
 praetorian = praetorian_cli.main:main

{praetorian_cli-2.2.17 → praetorian_cli-2.3.0}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = praetorian-cli
-version = 2.2.17
+version = 2.3.0
 author = Praetorian
 author_email = support@praetorian.com
 description = For interacting with the Chariot API
@@ -32,6 +32,7 @@ install_requires =
 [options.entry_points]
 console_scripts = 
 	praetorian = praetorian_cli.main:main
+	guard = praetorian_cli.main:guard_main
 
 [egg_info]
 tag_build =