neoagent 3.3.1-beta.1 → 3.3.1-beta.3

package/README.md

@@ -49,9 +49,14 @@ is available.
 
 ```bash
 npm install -g neoagent
-neoagent install
+neoagent
 ```
 
+On its first run, `neoagent` scans the computer for an existing instance. If
+none is found, it installs the application, prepares the service and isolated
+runtime, then opens a focused terminal wizard for your AI provider API keys.
+Running `neoagent` again shows the status of the existing installation.
+
 <p align="center">
   <a href="https://github.com/NeoLabs-Systems/NeoAgent/releases/latest"><img alt="Download macOS app" src="https://img.shields.io/badge/macOS_app-download-black?style=flat-square&logo=apple&logoColor=white"></a>
 </p>

package/docs/getting-started.md

@@ -29,12 +29,15 @@ the cloud browser/CLI become available once Docker is running.
 
 ```bash
 npm install -g neoagent
-neoagent install
+neoagent
 ```
 
-`neoagent install` checks the host, creates the runtime configuration, installs
-application dependencies and supported system tools, prepares the isolated
-runtime, and registers a launchd or systemd user service when available.
+The first `neoagent` run checks the host for an existing installation. On a new
+machine it creates the runtime configuration, installs application dependencies
+and supported system tools, prepares the isolated runtime, guides you through
+the API keys for the hosted providers you choose, and registers a launchd or
+systemd user service when available. Later runs show the existing
+installation's status.
 
 Read the post-install actions printed by the command. They describe anything
 the installer could not complete automatically.
@@ -45,10 +48,10 @@ and `PUBLIC_URL` before connecting integrations or mobile clients.
 ## First run
 
 1. Create the first user account.
-2. Open **Settings > AI Providers**.
-3. Configure a hosted provider or connect local Ollama.
-4. Select a model and send a message in **Chat**.
-5. Open **Settings > Tool Permissions** and review the approval policy before
+2. Open **Settings > AI Providers** and verify the provider configured by the
+   terminal wizard, or connect local Ollama.
+3. Select a model and send a message in **Chat**.
+4. Open **Settings > Tool Permissions** and review the approval policy before
    enabling browser, shell, file-write, desktop, or Android actions.
 
 The first isolated-runtime boot downloads and prepares an Ubuntu image. It can

package/docs/index.md

@@ -18,11 +18,13 @@ sensitive accounts.
 
 ```bash
 npm install -g neoagent
-neoagent install
+neoagent
 ```
 
-The installer starts the service and prints any host-specific action items.
-Open `http://localhost:3333` when it finishes.
+On a new machine, the bare command detects that NeoAgent is not installed,
+runs the installer, and guides you through AI provider API keys. It starts the
+service and prints any host-specific action items. Open
+`http://localhost:3333` when it finishes.
 
 Continue with:
 

package/flutter_app/lib/main_settings.dart

@@ -79,116 +79,143 @@ const Map<String, List<String>> _voiceLiveVoicesByProvider =
 class _SettingsSection {
   const _SettingsSection(
     this.title,
+    this.label,
+    this.icon,
     this.keywords, {
     this.requiresDesktop = false,
   });
 
   final String title;
+  final String label;
+  final IconData icon;
   final List<String> keywords;
   final bool requiresDesktop;
 }
 
-const _overviewSettingsSection = _SettingsSection('overview', <String>[
+const _overviewSettingsSection = _SettingsSection(
   'overview',
-  'summary',
-  'onboarding',
-  'platform',
-  'providers',
-]);
+  'Overview',
+  Icons.dashboard_outlined,
+  <String>['overview', 'summary', 'onboarding', 'platform', 'providers'],
+);
 
-const _workspaceSettingsSection = _SettingsSection('workspace', <String>[
+const _workspaceSettingsSection = _SettingsSection(
   'workspace',
-  'browser',
-  'extension',
-  'cli',
-  'claude code',
-  'desktop',
-  'routing',
-]);
-
-const _behaviorSettingsSection = _SettingsSection('behavior', <String>[
+  'Workspace',
+  Icons.workspaces_outline,
+  <String>[
+    'workspace',
+    'browser',
+    'extension',
+    'cli',
+    'claude code',
+    'desktop',
+    'routing',
+  ],
+);
+
+const _behaviorSettingsSection = _SettingsSection(
   'behavior',
-  'persona',
-  'social intelligence',
-  'turn taking',
-  'groups',
-  'memory',
-  'norms',
-  'theory of mind',
-  'delivery',
-]);
-
-const _modelsSettingsSection = _SettingsSection('models', <String>[
-  'models',
-  'providers',
-  'routing',
-  'fallback',
-  'chat',
-  'sub-agent',
-  'subagent',
-  'smart selector',
-]);
-
-const _socialReachSettingsSection = _SettingsSection('social reach', <String>[
-  'social',
-  'reach',
-  'web',
-  'rss',
-  'github',
-  'youtube',
-  'linkedin',
-  'xueqiu',
-  'twitter',
-  'reddit',
-  'instagram',
-  'facebook',
-  'cookies',
-]);
-
-const _voiceSettingsSection = _SettingsSection('voice', <String>[
+  'Behavior',
+  Icons.psychology_outlined,
+  <String>[
+    'behavior',
+    'persona',
+    'social intelligence',
+    'turn taking',
+    'groups',
+    'memory',
+    'norms',
+    'theory of mind',
+    'delivery',
+  ],
+);
+
+const _modelsSettingsSection =
+    _SettingsSection('models', 'Models & routing', Icons.hub_outlined, <String>[
+      'models',
+      'providers',
+      'routing',
+      'fallback',
+      'chat',
+      'sub-agent',
+      'subagent',
+      'smart selector',
+    ]);
+
+const _socialReachSettingsSection = _SettingsSection(
+  'social reach',
+  'Social reach',
+  Icons.public_outlined,
+  <String>[
+    'social',
+    'reach',
+    'web',
+    'rss',
+    'github',
+    'youtube',
+    'linkedin',
+    'xueqiu',
+    'twitter',
+    'reddit',
+    'instagram',
+    'facebook',
+    'cookies',
+  ],
+);
+
+const _voiceSettingsSection = _SettingsSection(
   'voice',
-  'speech',
-  'tts',
-  'stt',
-  'live',
-]);
+  'Voice',
+  Icons.mic_none_outlined,
+  <String>['voice', 'speech', 'tts', 'stt', 'live'],
+);
 
-const _desktopSettingsSection = _SettingsSection('desktop', <String>[
+const _desktopSettingsSection = _SettingsSection(
   'desktop',
-  'permissions',
-  'capture',
-  'companion',
-  'screen recording',
-  'accessibility',
-  'input',
-], requiresDesktop: true);
-
-const _diagnosticsSettingsSection = _SettingsSection('diagnostics', <String>[
+  'Desktop',
+  Icons.desktop_windows_outlined,
+  <String>[
+    'desktop',
+    'permissions',
+    'capture',
+    'companion',
+    'screen recording',
+    'accessibility',
+    'input',
+  ],
+  requiresDesktop: true,
+);
+
+const _diagnosticsSettingsSection = _SettingsSection(
   'diagnostics',
-  'logs',
-  'token',
-  'usage',
-  'debug',
-  'health',
-]);
-
-const _securitySettingsSection = _SettingsSection('security', <String>[
+  'Diagnostics',
+  Icons.monitor_heart_outlined,
+  <String>['diagnostics', 'logs', 'token', 'usage', 'debug', 'health'],
+);
+
+const _securitySettingsSection = _SettingsSection(
   'security',
-  'tool',
-  'permission',
-  'allowlist',
-  'shell',
-  'android',
-  'approval',
-  'policy',
-]);
+  'Permissions',
+  Icons.admin_panel_settings_outlined,
+  <String>[
+    'security',
+    'tool',
+    'permission',
+    'allowlist',
+    'shell',
+    'android',
+    'approval',
+    'policy',
+  ],
+);
 
 const List<_SettingsSection> _settingsSearchSections = <_SettingsSection>[
   _overviewSettingsSection,
-  _behaviorSettingsSection,
+  _modelsSettingsSection,
   _workspaceSettingsSection,
+  _behaviorSettingsSection,
   _socialReachSettingsSection,
-  _modelsSettingsSection,
   _voiceSettingsSection,
   _desktopSettingsSection,
   _securitySettingsSection,
@@ -197,6 +224,7 @@ const List<_SettingsSection> _settingsSearchSections = <_SettingsSection>[
 
 class _SettingsPanelState extends State<SettingsPanel> {
   late final TextEditingController _searchController;
+  _SettingsSection _selectedSettingsSection = _overviewSettingsSection;
   late String _browserBackend;
   String? _browserExtensionTokenId;
   late String _cliBackend;
@@ -433,11 +461,30 @@ class _SettingsPanelState extends State<SettingsPanel> {
               trailing: _settingsSaveButton(controller),
             )
           else
-            Align(
-              alignment: Alignment.centerRight,
-              child: Padding(
-                padding: const EdgeInsets.only(bottom: 12),
-                child: _settingsSaveButton(controller),
+            Padding(
+              padding: const EdgeInsets.only(bottom: 12),
+              child: Row(
+                children: <Widget>[
+                  Expanded(
+                    child: Column(
+                      crossAxisAlignment: CrossAxisAlignment.start,
+                      children: <Widget>[
+                        Text(
+                          'General settings',
+                          style: Theme.of(context).textTheme.titleLarge
+                              ?.copyWith(fontWeight: FontWeight.w800),
+                        ),
+                        const SizedBox(height: 2),
+                        Text(
+                          'Choose a category or search across all settings.',
+                          style: TextStyle(color: _textSecondary),
+                        ),
+                      ],
+                    ),
+                  ),
+                  const SizedBox(width: 12),
+                  _settingsSaveButton(controller),
+                ],
               ),
             ),
           if (controller.errorMessage != null) ...<Widget>[
@@ -462,36 +509,38 @@ class _SettingsPanelState extends State<SettingsPanel> {
                     ),
             ),
           ),
+          const SizedBox(height: 12),
+          _buildSettingsCategoryPicker(visibleSearchSections),
           const SizedBox(height: 16),
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _overviewSettingsSection,
           )) ...<Widget>[
             _buildSettingsOverview(controller, availableModels.length),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _behaviorSettingsSection,
           )) ...<Widget>[
             _buildBehaviorSection(controller, routingModels),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _workspaceSettingsSection,
           )) ...<Widget>[
             _buildWorkspaceSection(controller),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _socialReachSettingsSection,
           )) ...<Widget>[
             _buildSocialReachSection(controller),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _modelsSettingsSection,
           )) ...<Widget>[
@@ -505,7 +554,7 @@ class _SettingsPanelState extends State<SettingsPanel> {
             ),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _voiceSettingsSection,
           )) ...<Widget>[
@@ -517,21 +566,21 @@ class _SettingsPanelState extends State<SettingsPanel> {
             const SizedBox(height: 16),
           ],
           if (visibleSearchSections.contains(_desktopSettingsSection) &&
-              _matchesSettingsSection(
+              _showsSettingsSection(
                 searchQuery,
                 _desktopSettingsSection,
               )) ...<Widget>[
             _buildDesktopSection(controller),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _securitySettingsSection,
           )) ...<Widget>[
             _buildSecuritySection(context, controller),
             const SizedBox(height: 16),
           ],
-          if (_matchesSettingsSection(
+          if (_showsSettingsSection(
             searchQuery,
             _diagnosticsSettingsSection,
           )) ...<Widget>[_buildDiagnosticsSection(controller)],
@@ -560,6 +609,70 @@ class _SettingsPanelState extends State<SettingsPanel> {
     return haystack.contains(query);
   }
 
+  bool _showsSettingsSection(String query, _SettingsSection section) {
+    if (query.isNotEmpty) {
+      return _matchesSettingsSection(query, section);
+    }
+    return _selectedSettingsSection == section;
+  }
+
+  Widget _buildSettingsCategoryPicker(Set<_SettingsSection> visibleSections) {
+    final sections = _settingsSearchSections
+        .where(visibleSections.contains)
+        .toList();
+    return LayoutBuilder(
+      builder: (context, constraints) {
+        if (constraints.maxWidth < 620) {
+          return DropdownButtonFormField<_SettingsSection>(
+            key: ValueKey<_SettingsSection>(_selectedSettingsSection),
+            initialValue: _selectedSettingsSection,
+            isExpanded: true,
+            decoration: const InputDecoration(
+              labelText: 'Category',
+              prefixIcon: Icon(Icons.category_outlined),
+            ),
+            items: sections
+                .map(
+                  (section) => DropdownMenuItem<_SettingsSection>(
+                    value: section,
+                    child: Row(
+                      children: <Widget>[
+                        Icon(section.icon, size: 18),
+                        const SizedBox(width: 10),
+                        Text(section.label),
+                      ],
+                    ),
+                  ),
+                )
+                .toList(),
+            onChanged: (section) {
+              if (section == null) return;
+              _searchController.clear();
+              setState(() => _selectedSettingsSection = section);
+            },
+          );
+        }
+        return Wrap(
+          spacing: 8,
+          runSpacing: 8,
+          children: sections
+              .map(
+                (section) => ChoiceChip(
+                  avatar: Icon(section.icon, size: 17),
+                  label: Text(section.label),
+                  selected: _selectedSettingsSection == section,
+                  onSelected: (_) {
+                    _searchController.clear();
+                    setState(() => _selectedSettingsSection = section);
+                  },
+                ),
+              )
+              .toList(),
+        );
+      },
+    );
+  }
+
   bool _noSettingsMatches(
     String query,
     Iterable<_SettingsSection> visibleSections,