Manage AI resources

As an administrator, you see which repositories Astrolabe reads, what each reading found or why it failed, and every AI resource of the catalog in one table.

Before you start

AI resources is on: see Turn on AI resources.

📋 See the repositories read

1. In the left sidebar, at the bottom, click Administration.

2. Under INTELLIGENCE, click AI resources. The tab Repositories opens.

3. Under Annotated repositories, read one row per repository: Repository, State, Last reading, Commit, Resources (for example 2 skills · 1 agent) and Problem.

   State	Meaning
   Read	The repository was read and nothing is wrong.
   Read, with problems	The repository was read; the problems are written in the column Problem, up to three, then + 1 more problem on the repository tab.
   Reading failed	Astrolabe could not read the repository. The column Problem gives the cause.

4. Click the name of a repository, or Open the repository, to open its tab AI resources. On a row whose reading failed because of the connection, click Fix the connection.

▶️ Read the repositories now

1. On the tab Repositories, click Run now. The message Scan started. appears at the bottom of the screen and the button says Reading….

2. Wait for the end. The message says Scan over: 3 repositories read., or, when some failed, Scan over: 2 of 4 repositories could not be read. It stays on the screen until you close it.

The table updates by itself.

📚 List every AI resource

Under the table of repositories, the table AI resources lists every resource of the catalog: Name, Type, Owner, Repository, Score and Could run. Click Type or Owner and pick a value to filter.

⚙️ Set the readings

1. On the tab Repositories, click Scan settings. The tab Settings opens, under Administration › Plugins › AI resources. The line This plugin is configured. appears at the top.

2. The switch Read on a schedule is on, with Default value under it: Astrolabe reads the repositories on its own. Set Minutes between two readings (30, and 5 at least).

3. Set the limits of one reading:

   Field	What it limits	Value shown
   Repositories read at most	Annotated repositories read in one pass	200
   Files per repository	Files read in one repository	2000
   AI resources per repository	AI resources kept from one repository	300
   File size (KB)	Size of one file	256
   Repository size (MB)	Size of one repository archive	50

4. Click Save.

Not verified on an instance yet: saving the settings.

🚨 See a failing repository from every page

1. In the left sidebar, click Administration. The tab Problems opens.

2. Find the block AI resources. It names the repositories Astrolabe could not read and the cause, for example github.com answers something unexpected. Check the host and the API URL.

3. Click Fix it. The connection that holds the cause opens.

✅ That's it!

Next: Troubleshooting.