gibson-cli 0.7.5__py3-none-any.whl → 0.7.6__py3-none-any.whl

gibson/command/code/Schema.py

@@ -14,9 +14,7 @@ class Schema(BaseCommand):
         self.configuration.require_project()
         entity = self.memory.recall_stored_entity(entity_name)
         if entity is None:
-            self.conversation.not_sure_no_entity(
-                self.configuration.project.name, entity_name
-            )
+            self.conversation.not_sure_no_entity(self.configuration, entity_name)
             exit(1)
 
         time_keeper = TimeKeeper()
@@ -24,15 +22,18 @@ class Schema(BaseCommand):
         with Spinner("Gibson is writing the schemas...", "Schemas written"):
             cli = Cli(self.configuration)
             response = cli.code_schemas([entity["name"]])
-            Dev(self.configuration).schema(
-                response["code"][0]["entity"]["name"], response["code"][0]["definition"]
-            )
+            code = response["code"][0] if len(response["code"]) > 0 else None
+            if code:
+                Dev(self.configuration).schema(
+                    code["entity"]["name"], code["definition"]
+                )
 
-        if self.configuration.project.dev.active is True:
+        if code and self.configuration.project.dev.active is True:
             self.conversation.type(
                 f"\nGibson wrote the following {Colors.argument('schema')} code to your project:\n"
             )
 
         if not self.conversation.muted():
-            print(response["code"][0]["definition"])
+            if code:
+                print(code["definition"])
             time_keeper.display()

gibson/command/code/Test.py

@@ -14,9 +14,7 @@ class Test(BaseCommand):
         self.configuration.require_project()
         entity = self.memory.recall_stored_entity(entity_name)
         if entity is None:
-            self.conversation.not_sure_no_entity(
-                self.configuration.project.name, entity_name
-            )
+            self.conversation.not_sure_no_entity(self.configuration, entity_name)
             exit(1)
 
         time_keeper = TimeKeeper()

gibson/command/importer/Import.py

@@ -56,7 +56,7 @@ class Import(BaseCommand):
         self.conversation.type("Building schema...\n")
 
         for entity in response["project"]["entities"]:
-            self.conversation.type(f"    {entity['name']}\n", delay=0.002)
+            self.conversation.type(f"    {entity['name']}\n")
 
         return response["project"]["entities"]
 
@@ -74,7 +74,7 @@ class Import(BaseCommand):
         entities = []
         for table in tables:
             if table[0] not in table_exceptions:
-                self.conversation.type(f"    {table[0]}\n", delay=0.002)
+                self.conversation.type(f"    {table[0]}\n")
 
                 create_statement = session.execute(
                     f"show create table {table[0]}"
@@ -139,7 +139,7 @@ class Import(BaseCommand):
 
         entities = []
         for table_name, definition in tables.items():
-            self.conversation.type(f"    {table_name}\n", delay=0.002)
+            self.conversation.type(f"    {table_name}\n")
 
             definition[-1] = definition[-1].rstrip(",")
 
@@ -160,19 +160,19 @@ class Import(BaseCommand):
             else ""
         )
         self.conversation.type(
-            f"usage: {Colors.command(self.configuration.command)} {Colors.subcommand('import')} {Colors.arguments(['api', 'mysql', 'pg_dump', 'openapi'])} {Colors.hint('import entities')}\n"
+            f"usage: {Colors.command(self.configuration.command, 'import', args=['api', 'mysql', 'pg_dump', 'openapi'], hint='import entities')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('import')} {Colors.argument('api')} {Colors.hint(f'import all entities from your project created on {Colors.link(self.configuration.app_domain())}')}\n"
+            f"       {Colors.command(self.configuration.command, 'import', args='api', hint=f'import all entities from your project created on {Colors.link(self.configuration.app_domain())}')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('import')} {Colors.argument('mysql')} {Colors.hint('import all entities from your MySQL database')} ({Colors.link(datastore_uri)})\n"
+            f"       {Colors.command(self.configuration.command, 'import', args='mysql', hint='import all entities from your MySQL database')} ({Colors.link(datastore_uri)})\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('import')} {Colors.argument('pg_dump')} {Colors.input('path/to/pg_dump.sql')} {Colors.hint('import all entities from a pg_dump file')}\n"
+            f"       {Colors.command(self.configuration.command, 'import', args='pg_dump', inputs='path/to/pg_dump.sql', hint='import all entities from a pg_dump file')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('import')} {Colors.argument('openapi')} {Colors.input('path/to/openapi.json')} {Colors.hint('import all entities from an OpenAPI spec file')}\n"
+            f"       {Colors.command(self.configuration.command, 'import', args='openapi', inputs='path/to/openapi.json', hint='import all entities from an OpenAPI spec file')}\n"
         )
         self.conversation.newline()
         exit(1)

gibson/command/importer/OpenApi.py

@@ -46,7 +46,7 @@ class OpenApi(BaseCommand):
 
         i = 0
         for path in path_list:
-            self.conversation.type(f"   {i}: ".rjust(10) + path + "\n", delay=0.0009)
+            self.conversation.type(f"   {i}: ".rjust(10) + path + "\n")
             i += 1
 
         self.conversation.newline()

gibson/command/list/Entities.py

@@ -1,5 +1,10 @@
 import sys
 
+from rich import box
+from rich.console import Console
+from rich.table import Table
+from rich.text import Text
+
 from gibson.command.BaseCommand import BaseCommand
 
 
@@ -8,44 +13,27 @@ class Entities(BaseCommand):
         self.configuration.require_project()
         self.configuration.display_project()
 
-        entities = {"last": [], "stored": []}
-
-        last = self.memory.recall_last()
-        if last is not None:
-            for entity in last["entities"]:
-                entities["last"].append(entity["name"])
-
-        stored = self.memory.recall_entities()
-        if stored is not None:
-            for entity in stored:
-                entities["stored"].append(entity["name"])
+        last = self.memory.recall_last() or []
+        stored = self.memory.recall_entities() or []
 
-        if len(entities["last"]) == 0 and len(entities["stored"]) == 0:
+        if len(last) == 0 and len(stored) == 0:
             self.conversation.nothing_to_list(sys.argv[2])
             self.conversation.newline()
         else:
-            self.conversation.type("    Name".ljust(60), delay=0.0001)
-            self.conversation.type("Memory", delay=0.002)
-            self.conversation.newline()
-            self.conversation.type("    ----".ljust(60), delay=0.0001)
-            self.conversation.type("------", delay=0.002)
-            self.conversation.newline()
-
-            entities["last"].sort()
-            entities["stored"].sort()
-
-            if len(entities["stored"]) > 0:
-                for entity in entities["stored"]:
-                    self.conversation.type(f"    {entity}".ljust(60), delay=0.0001)
-                    self.conversation.type("[stored]", delay=0.002)
-                    self.conversation.newline()
-
-                self.conversation.newline()
-
-            if len(entities["last"]) > 0:
-                for entity in entities["last"]:
-                    self.conversation.type(f"    {entity}".ljust(60), delay=0.0001)
-                    self.conversation.type("[last]", delay=0.002)
-                    self.conversation.newline()
-
-                self.conversation.newline()
+            console = Console()
+            table = Table(
+                title="Entities",
+                header_style="bold",
+                box=box.ROUNDED,
+                leading=1,
+            )
+            table.add_column("Name", style="magenta", header_style="magenta")
+            table.add_column("Memory")
+
+            for entity in sorted(stored, key=lambda x: x["name"]):
+                table.add_row(entity["name"], Text("stored", style="green"))
+
+            for entity in sorted(last, key=lambda x: x["name"]):
+                table.add_row(entity["name"], Text("last", style="yellow"))
+
+            console.print(table)

gibson/command/list/List.py

@@ -18,13 +18,13 @@ class List(BaseCommand):
     def usage(self):
         self.configuration.display_project()
         self.conversation.type(
-            f"usage: {Colors.command(self.configuration.command)} {Colors.subcommand('list')} {Colors.arguments(['entities', 'projects'])}\n"
+            f"usage: {Colors.command(self.configuration.command, 'list', args=['entities', 'projects'])}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('list')} {Colors.argument('entities')} {Colors.hint('list all entities')}\n"
+            f"       {Colors.command(self.configuration.command, 'list', args='entities', hint='list all entities')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('list')} {Colors.argument('projects')} {Colors.hint('list all projects')}\n"
+            f"       {Colors.command(self.configuration.command, 'list', args='projects', hint='list all projects')}\n"
         )
         self.conversation.newline()
         exit(1)

gibson/command/list/Projects.py

@@ -1,31 +1,41 @@
-import re
+from rich import box
+from rich.console import Console
+from rich.table import Table
 
 import gibson.core.Colors as Colors
 from gibson.api.ProjectApi import ProjectApi
 from gibson.command.BaseCommand import BaseCommand
+from gibson.core.Spinner import DisappearingSpinner
 
 
 class Projects(BaseCommand):
     def execute(self):
         self.configuration.require_login()
-        projects = ProjectApi(self.configuration).all_projects()
+
+        with DisappearingSpinner():
+            projects = ProjectApi(self.configuration).all_projects()
 
         if len(projects) == 0:
             self.conversation.type(
-                f"No projects found. Create one with {Colors.command('gibson')} {Colors.subcommand('new')} {Colors.argument('project')}\n"
+                f"No projects found. Create one with {Colors.command(self.configuration.command, 'new', args='project')}\n"
             )
             exit(1)
 
-        self.conversation.type("Name".ljust(40))
-        self.conversation.type("ID")
-        self.conversation.newline()
-        self.conversation.type("----".ljust(40))
-        self.conversation.type("-" * 36)
-        self.conversation.newline()
+        console = Console()
+        table = Table(
+            title="Projects",
+            header_style="bold magenta",
+            box=box.ROUNDED,
+            leading=1,
+        )
+        table.add_column("Name")
+        table.add_column("ID", min_width=36)
 
         for project in projects:
             name = project["name"] if project["name"] is not None else "Untitled"
-            name = re.sub(r"^(.{36}).*$", "\g<1>...", name).ljust(40)
-            self.conversation.type(f"{Colors.command(name)}")
-            self.conversation.type(f"{project['uuid']}")
-            self.conversation.newline()
+            table.add_row(
+                name,
+                project["uuid"],
+            )
+
+        console.print(table)

gibson/command/new/Module.py

@@ -34,7 +34,7 @@ class Module(BaseCommand):
         self.conversation.newline()
         self.conversation.type(f"If you want to persist these new entities run:\n")
         self.conversation.type(
-            f"{Colors.command(self.configuration.command)} {Colors.subcommand('merge')}\n"
+            f"{Colors.command(self.configuration.command, 'merge')}\n"
         )
 
         self.conversation.newline()
@@ -42,5 +42,5 @@ class Module(BaseCommand):
             f"Afterwards, you can modify any of these entities by running:\n"
         )
         self.conversation.type(
-            f"{Colors.command(self.configuration.command)} {Colors.subcommand('modify')} {Colors.argument('[entity name]')} {Colors.input('[instructions]')}\n"
+            f"{Colors.command(self.configuration.command, 'modify', inputs=['[entity name]', '[instructions]'])}\n"
         )

gibson/command/new/New.py

@@ -21,16 +21,16 @@ class New(BaseCommand):
     def usage(self):
         self.configuration.display_project()
         self.conversation.type(
-            f"usage: {Colors.command(self.configuration.command)} {Colors.subcommand('new')} {Colors.arguments(['project', 'module', 'entity'])} {Colors.hint('create something new')}\n"
+            f"usage: {Colors.command(self.configuration.command, 'new', args=['project', 'module', 'entity'], hint='create something new')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('new')} {Colors.argument('project')} {Colors.hint('create a new project')}\n"
+            f"       {Colors.command(self.configuration.command, 'new', args='project', hint='create a new project')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('new')} {Colors.argument('module')} {Colors.hint('create a new module')}\n"
+            f"       {Colors.command(self.configuration.command, 'new', args='module', hint='create a new module')}\n"
         )
         self.conversation.type(
-            f"       {Colors.command(self.configuration.command)} {Colors.subcommand('new')} {Colors.argument('entity')} {Colors.input('[entity name]')} {Colors.hint('create a new entity')}\n"
+            f"       {Colors.command(self.configuration.command, 'new', args='entity', inputs='[entity name]', hint='create a new entity')}\n"
         )
         self.conversation.newline()
         exit(1)

gibson/command/rename/Rename.py

@@ -15,7 +15,7 @@ class Rename(BaseCommand):
     def usage(self):
         self.configuration.display_project()
         self.conversation.type(
-            f"usage: {Colors.command(self.configuration.command)} {Colors.subcommand('rename')} {Colors.argument('entity')} {Colors.input('[existing name]')} {Colors.input('[new name]')} {Colors.hint('rename an entity')}\n"
+            f"usage: {Colors.command(self.configuration.command, 'rename', args='entity', inputs=['[existing name]', '[new name]'], hint='rename an entity')}\n"
         )
         self.conversation.newline()
         exit(1)

gibson/command/rewrite/Rewrite.py

@@ -115,7 +115,7 @@ class Rewrite(BaseCommand):
     def usage(self):
         self.configuration.display_project()
         self.conversation.type(
-            f"usage: {Colors.command(self.configuration.command)} {Colors.subcommand('rewrite')} {Colors.hint('rewrite all code')}\n"
+            f"usage: {Colors.command(self.configuration.command, 'rewrite', hint='rewrite all code')}\n"
         )
         self.conversation.newline()
         exit(1)

gibson/core/Colors.py

@@ -46,8 +46,30 @@ def colorize(text, color):
 
 
 # Colorize a command
-def command(text):
-    return green(text)
+def command(
+    command,
+    sub=None,
+    args=None,
+    inputs=None,
+    hint=None,
+):
+    parts = [green(command)]
+    if sub:
+        parts.append(subcommand(sub))
+    if args:
+        if isinstance(args, list):
+            parts.append(arguments(args))
+        else:
+            parts.append(argument(args))
+    if inputs:
+        if isinstance(inputs, list):
+            for input_ in inputs:
+                parts.append(user_input(input_))
+        else:
+            parts.append(user_input(inputs))
+    if hint:
+        parts.append(grey(hint))
+    return " ".join(parts)
 
 
 # Colorize a subcommand
@@ -66,7 +88,7 @@ def arguments(list):
 
 
 # Colorize user input
-def input(text):
+def user_input(text):
     return white(text)
 
 
@@ -90,15 +112,20 @@ def link(text):
     return underline(blue(text))
 
 
+# Colorize an entity name
+def entity(text):
+    return bold(violet(text))
+
+
 # Colorize the table name in a SQL statement
 def table(sql, name):
-    return sql.replace(name, violet(name))
+    return sql.replace(name, entity(name), 1)
 
 
 # Colorize the table name in model code
-def model(code, name):
-    return code.replace(
-        f'__tablename__ = "{name}"', f'__tablename__ = "{violet(name)}"'
+def model(code, model_name, entity_name):
+    return code.replace(model_name, entity(model_name), 1).replace(
+        f'__tablename__ = "{entity_name}"', f'__tablename__ = "{entity(entity_name)}"'
     )
 
 

gibson/core/CommandRouter.py

@@ -20,7 +20,6 @@ from gibson.command.rewrite.Rewrite import Rewrite
 from gibson.command.Show import Show
 from gibson.command.Tree import Tree
 from gibson.command.Version import Version
-from gibson.command.WarGames import WarGames
 from gibson.core.Configuration import Configuration
 from gibson.core.Conversation import Conversation
 from gibson.core.Env import Env

gibson/core/Configuration.py

@@ -313,7 +313,7 @@ class Configuration:
 
     def require_login(self):
         if self.get_access_token() is None:
-            self.conversation.message_login_required()
+            self.conversation.message_login_required(self)
             exit(1)
 
         return self
@@ -329,9 +329,12 @@ class Configuration:
 
         return self
 
-    def require_project_key(self):
+    def require_project_key_or_id(self):
+        if self.project.id:
+            return self
+
         if not self.project.api.key or self.project.api.key == "FIXME":
-            self.conversation.project_api_key_not_set(self.app_domain())
+            self.conversation.project_api_key_not_set(self)
             exit(1)
 
         return self
@@ -345,6 +348,7 @@ class Configuration:
         with open(f"{self.paths.auth}/{self.API_ENV}", "w") as f:
             data = {"access_token": access_token, "refresh_token": refresh_token}
             json.dump(data, f, indent=2)
+            f.write("\n")
 
     def set_config_paths(self):
         config_path = os.environ.get("GIBSONAI_CONFIG_PATH", None)
@@ -448,6 +452,7 @@ class Configuration:
 
         with open(self.paths.config, "w") as f:
             json.dump(self.settings, f, indent=2)
+            f.write("\n")
 
         self.read_config()
 

gibson/core/Conversation.py

@@ -10,10 +10,9 @@ from gibson.conf.Version import Version
 
 
 class Conversation:
-    DEFAULT_DELAY = 0.01
+    DEFAULT_DELAY = 0
 
     def __init__(self):
-        self.__delay = self.DEFAULT_DELAY
         self.__mute = False
 
     def c64_boot_loading(self):
@@ -101,7 +100,7 @@ class Conversation:
     def message_configuration_added(self, config_path, section):
         self.type(f"I store my configuration in this file:\n\n{config_path}\n\n")
         self.type("And I just added this section to the configuration:\n\n")
-        self.type(f"{section}\n", delay=0.002)
+        self.type(f"{section}\n")
         return self
 
     def message_customize_settings(self):
@@ -133,10 +132,10 @@ class Conversation:
         self.type("Login failed, please try again.\n")
         return self
 
-    def message_login_required(self):
+    def message_login_required(self, configuration):
         self.type("You need to login before performing this action.\n")
         self.type(
-            f"Run {Colors.command('gibson')} {Colors.subcommand('auth')} {Colors.argument('login')} and try again.\n"
+            f"Run {Colors.command(configuration.command, 'auth', args='login')} and try again.\n"
         )
         return self
 
@@ -198,15 +197,18 @@ class Conversation:
         else:
             self.type("Back...again? You know what to do.\n\n")
 
-    def not_sure_no_entity(self, project_name, entity_name):
-        self.display_project(project_name)
-        self.type(f'Not sure what to do. "{entity_name}" does not exist.\n\n')
+    def not_sure_no_entity(self, configuration, entity_name):
+        self.display_project(configuration.project.name)
+        self.type(
+            f"No entity named {Colors.entity(entity_name)} exists. You can create it by executing:\n\n"
+        )
+        self.type(
+            f"{Colors.command(configuration.command, 'code', args='entity', inputs=entity_name)}\n\n"
+        )
         return self
 
     def nothing_to_list(self, whats_being_listed):
-        self.type(
-            f"There is only so much I can do. No {whats_being_listed}, nothing to list."
-        )
+        self.type(f"No {whats_being_listed} to list.")
         self.newline()
 
     def pause(self):
@@ -216,17 +218,17 @@ class Conversation:
         self.type(f'\nA project named "{project_name}" already exists.\n')
         self.newline()
 
-    def project_api_key_not_set(self, domain):
+    def project_api_key_not_set(self, configuration):
         self.type(
             f"\nYou have not set the API key for your project. Please set the API key by executing:\n"
         )
         self.newline()
         self.type(
-            f"{Colors.command('gibson')} {Colors.subcommand('conf')} {Colors.argument('api::key')} {Colors.input('[API key]')}\n"
+            f"{Colors.command(configuration.command, 'conf', args='api::key', inputs='[API key]')}\n"
         )
         self.newline()
         self.type(
-            f"If you don't have an API key, you can get one by creating a new project at {Colors.link(domain + '/chat')}\n"
+            f"If you don't have an API key, you can get one by creating a new project at {Colors.link(configuration.app_domain() + '/chat')}\n"
         )
         self.newline()
 
@@ -272,10 +274,6 @@ class Conversation:
         print("+" + "-" * 75 + "+\n")
         return self
 
-    def set_delay(self, delay):
-        self.__delay = delay
-        return self
-
     def spin(self, thread: threading.Thread):
         animation = self.spinner()
         while thread.is_alive():
@@ -289,15 +287,10 @@ class Conversation:
             for cursor in "|/-\\":
                 yield cursor
 
-    def type(self, message, delay=None):
+    def type(self, message, delay=DEFAULT_DELAY):
         if self.__mute is True:
             return self
 
-        if delay is None:
-            delay = self.DEFAULT_DELAY
-            if self.__delay is not None:
-                delay = self.__delay
-
         try:
             for char in message:
                 sys.stdout.write(char)

gibson/core/Memory.py

@@ -106,6 +106,7 @@ class Memory:
     def __remember(self, file, data):
         with open(file, "w") as f:
             json.dump(data, f, indent=2)
+            f.write("\n")
 
         return self
 

gibson/core/Spinner.py

@@ -4,7 +4,7 @@ from yaspin.spinners import Spinners
 
 class Spinner:
     def __init__(
-        self, start_text, success_text=None, fail_text=None, disappearing=False
+        self, start_text="", success_text=None, fail_text=None, disappearing=False
     ):
         self.success_text = success_text or start_text
         self.fail_text = fail_text or start_text
@@ -32,6 +32,11 @@ class Spinner:
         self.spinner.stop()
 
 
-class ComputingSpinner(Spinner):
+class DisappearingSpinner(Spinner):
+    def __init__(self, start_text="", success_text=None, fail_text=None):
+        super().__init__(start_text, success_text, fail_text, disappearing=True)
+
+
+class ComputingSpinner(DisappearingSpinner):
     def __init__(self):
-        super().__init__("Gibson is computing...", disappearing=True)
+        super().__init__("Gibson is computing...")

{gibson_cli-0.7.5.dist-info → gibson_cli-0.7.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: gibson-cli
-Version: 0.7.5
+Version: 0.7.6
 Summary: Gibson Command Line Interface
 Author-email: GibsonAI <noc@gibsonai.com>
 Project-URL: Homepage, https://gibsonai.com/
@@ -20,10 +20,10 @@ Requires-Dist: certifi==2024.2.2
 Requires-Dist: charset-normalizer==3.3.2
 Requires-Dist: click==8.1.7
 Requires-Dist: dnspython==2.6.1
-Requires-Dist: email-validator==2.1.1
+Requires-Dist: email_validator==2.1.1
 Requires-Dist: exceptiongroup==1.2.0
 Requires-Dist: Faker==24.0.0
-Requires-Dist: faker-sqlalchemy==0.10.2208140
+Requires-Dist: faker_sqlalchemy==0.10.2208140
 Requires-Dist: fastapi==0.111.0
 Requires-Dist: fastapi-cli==0.0.2
 Requires-Dist: h11==0.14.0
@@ -40,7 +40,7 @@ Requires-Dist: orjson==3.10.3
 Requires-Dist: packaging==23.2
 Requires-Dist: pluggy==1.4.0
 Requires-Dist: pydantic==2.6.1
-Requires-Dist: pydantic-core==2.16.2
+Requires-Dist: pydantic_core==2.16.2
 Requires-Dist: pyfiglet==1.0.2
 Requires-Dist: Pygments==2.18.0
 Requires-Dist: PyMySQL==1.1.0
@@ -50,15 +50,16 @@ Requires-Dist: python-dotenv==1.0.1
 Requires-Dist: python-multipart==0.0.9
 Requires-Dist: PyYAML==6.0.1
 Requires-Dist: requests==2.31.0
-Requires-Dist: rich==13.7.1
+Requires-Dist: rich==13.9.2
 Requires-Dist: shellingham==1.5.4
 Requires-Dist: six==1.16.0
 Requires-Dist: sniffio==1.3.1
 Requires-Dist: SQLAlchemy==1.4.41
 Requires-Dist: starlette==0.37.2
+Requires-Dist: textual==0.83.0
 Requires-Dist: tomli==2.0.1
 Requires-Dist: typer==0.12.3
-Requires-Dist: typing-extensions==4.9.0
+Requires-Dist: typing_extensions==4.9.0
 Requires-Dist: ujson==5.9.0
 Requires-Dist: urllib3==1.26.6
 Requires-Dist: uvicorn==0.29.0
@@ -84,12 +85,20 @@ Portions of the Gibson backend code are written by Gibson.  So far, versus a hum
 
 ## Installation / Upgrading
 
-Install the latest version of the CLI using pip.
+Install the latest version of the CLI using `pip`
 
 ```sh
 pip3 install gibson-cli --upgrade
 ```
 
+Note: the first time you install any package from PyPI via `pip` that includes an executable, it is placed in a directory that is likely not in your `PATH`. There are a number of ways to do this, but one method is to run the following command:
+
+```sh
+echo 'export PATH="$PATH:${$(which python3)%python3}"' >> ~/.zshrc # or ~/.bashrc
+```
+
+You will only need to do this once.
+
 ## Key Terms
 
 - Dev Mode